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The equipment described in this manual generates and uses 
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This equipment has been tested and complies with the limits for a Class B 
computing device in accordance with the specifications in Subpart J, 

Part 15, of FCC rules. These rules are designed to provide reasonable 
protection against such interference in a residential installation. However, 
there is no guarantee that the interference will not occur in a particular 
installation, especially if a “rabbit ear” television antenna (the 
telescoping-rod type) is used. 


You can determine whether your computer is causing interference by 
turning it off. If the interference stops, it was probably caused by the 
computer or its peripherals. To further isolate the problem, disconnect the 
peripheral devices and their input/output cables one at a time. If the 
interference stops, it was caused by either the peripheral device or the I/O 
cable. These devices usually require shielded I/O cables. For Apple 
peripherals, you can obtain the proper shielded cable from your dealer. For 
non-Apple peripheral devices, contact the manufacturer or dealer for 
assistance. 


If your computer does cause interference to radio or television reception, 
you can try to correct the interference by doing one or more of the following: 


o Turn the television or radio antenna until the interference stops. 

oO Move the computer to one side or the other of the television or radio. 

O Move the computer farther away from the television or radio. 

O Plug the computer into an outlet that is on a different circuit than the 
television or radio. (That is, make certain the computer and the radio or 
TV are on circuits controlled by different circuit breakers or fuses. ) 

O Consider installing a rooftop television antenna with coaxial cable lead-in 
between the antenna and television. 


If necessary, you should consult your Apple-authorized dealer or an 
experienced radio/television technician for additional suggestions. 
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Preface 


About This Manual 


This is the reference manual for the Apple® IIc personal computer. You will 
find a description here of all the hardware and firmware components of the 
Apple llc. 


The information in this manual is aimed at assembly-language 
programmers and hardware designers, but others interested in the internal 
operation of the Apple IIc can also benefit from reading it. 


This manual tells you how the Apple IIc works, but not how to use the 
Apple IIc. If you need to know this, you should read other Apple IIc 
manuals, particularly the Apple [Jc Owner's Manual. 


This manual describes two versions of the Apple IIc: the original Apple IIc 
and a newer version that supports UniDisk™ 38.5. Information specific to the 
newer version of the machine is marked throughout the manual with 
UniDisk 3.5 in the margin of the text. If you buy a UniDisk 3.5 for your 
original IIc, your dealer will install a new ROM to make your IIc equivalent 
to the newer version. 


The following features have been added to the built-in firmware in the 
newer IIc: 


o the Protocol Converter (Chapter 6) 

O some new Serial port commands (Chapters 7 and 8) 

o the Mini-Assembler (Chapter 10) 

O new Monitor commands STEP and TRACE (Chapter 10) 


Changes have also been made to the built-in interrupt and mouse-interrupt 
handlers (Chapter 9 and Appendix E) and external drive startup procedures 
(Chapter 6). 


Which Version Do You Have? You can quickly tell which version of 
the Apple IIc you have by checking the value of ROM location 64447 
($FBBF hexadecimal). From Applesoft type PRINT PEEK(64447). The 
value printed is 255 if your Apple IIc is an original version, and 0 if your 
Apple IIc supports UniDisk 3.5. 
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Contents of This Manual 
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The Apple IIc is presented here from the outside in. 


Chapter | introduces the major physical features of the Apple IIc, including 
external controls and connectors and the major internal components of the 
machine. 


Chapter 2 introduces the 65C02 microprocessor, which is the heart of the 
Apple IIc. It discusses the processor’s address space, what resides in that 
space, and how to control it. 


Chapter 38 introduces the I/O characteristics of the Apple IIc. Chapters 4 
through 9 cover specific I/O devices. 


O Chapter 4 describes the keyboard and speaker. 

Chapter 5 describes the video display. 

Chapter 6 describes the disk drive and the Protocol Converter . 
Chapter 7 describes serial port 1, generally used to control primters. 
Chapter 8 describes serial port 2, generally used to control modems. 
oO Chapter 9 describes the mouse, game paddle, and joystick port. 


a) 


O O O 


Chapter 10 covers the Monitor built into the Apple IIc’s firmware. The 
Monitor helps you write, disassemble, and debug machine-language 
programs and inspect and manipulate Apple IIc memory contents. 


Chapter 11 describes in detail the Apple IIc’s hardware. It is intended to 
help programmers, but others may find the description useful. 


Appendix A describes the differences between the 6502 used on most 
members of the Apple II family and the 65C02 used by the Apple IIc and 
enhanced Apple Ile. Most of the chapter is a reprint of the manufacturer's 
data sheet for the 65C02. 


Appendix B contains a memory map of the Apple IIc including detailed 
maps of page $00, page $08, the screen holes, and the hardware page. 


Appendix C lists the published entry points of the Apple IIc’s firmware. The 
list, arranged by address, includes the I/O firmware ($C300 thro ugh 
$CFFF) and the Monitor firmware ($F000 through $FFFF). Addresses for 
the Applesoft interpreter firmware ($D000 through $F7FF) are listed in the 
Applesoft BASIC Programmer’s Reference Manual. 


Appendix D discusses some of the most common operating systems and 
languages that run on the Apple IIc, and what special features of the 
machine they do or don’t use. 
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Important! 


Appendix E describes how the Apple IIc’s interrupt firmware operates and 
how to use it in your own programs. 


Appendix F outlines the differences and similarities between the different 
members of the Apple II family. 


Appendix G describes the keyboard layouts, code conversion tables, and 
external power requirements of USA and international models of the Apple 
IIc. 


Appendix H contains tables to aid you in code and number base 
conversions. 


Appendix 1 is a listing of the source code of the firmware of the version of 
the IIc that supports UniDisk 3.5. If you find that you absolutely must 
develop software or hardware for an original IIc that will not be upgraded 
in the future, you can get a listing of the old source code by filling out and 
mailing the order form in the back of this manual. 


The glossary defines many of the technical terms used in this manual. 


The bibliography lists articles and books with additional information about 
the Apple IIc and related products. 


Finally, after the index at the back of this manual there is a Tell Apple 
Card. Please fill it out and send it in. Your experience with the manual can 
help us plan new reference materials. 


Symbols Used in This Manual 


This manual uses a numbering system to make it easier to cross-reference 
information. A reference like 2.4.6 means Chapter 2, Section 4, subsection 6. 
A reference like F'.6.2 refers to Appendix F’, Section 6, subsection 2. 


Look for these visual cues throughout the manual: 


Important information about your safety or the safety of your data 
appears like this. 


Text set off like this—and with a tag in the margin—presents important 
information. 


UniDisk 3.5 Text set off like this presents information specific to the newer IIc, which 


supports UniDisk 3.5. 
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By the Way: Text set off this way presents incidental information that 
you may find interesting. 


You will also see a special typeface used for what you type or for text that 
appears on your video display: 


It looks like this. 


Cross-references and definitions appear in Keys look like this: [~), (G), (RETURN }. When you see a hyphen joining two 
marginal notes like this. keys, it means to press them simultaneously. For instance, 


means all three keys should be pressed at the same 
time. 
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Chapter 1 Introduction 


This chapter introduces you to the working parts of the Apple® ILc by 
briefly describing the major components of the computer—both internal 
and external hardware and firmware—and telling you where in the manual 
to find out more about them. 


1.1 Outside of Machine 


This section briefly describes the Apple IIc’s keyboard, controls, indicators, 
and expansion connectors. 


The Apple IIc comes equipped with a keyboard, speaker (with audio output 
jack and volume control), built-in disk drive, external power supply, and 
internal voltage converter. It also has built-in interfaces with external 
connectors for a serial printer, video monitor, special video displa y adapters, 
modem, mouse, and game controllers. These external connectors allow you 
to plug in accessory equipment without having to go inside the m achine to 
use expansion Slots like those in the Apple Ile. 


Figure 1-1 shows the front and right side of an Apple IIc, and Figure 1-2 
shows the back and left side. 


Figure 1-1. Apple IIc External Figure 1-2. Apple IIc External 
Features (Front) Features (Back) 


Keyboard Disk Drive Back Panel Speaker 
(See Figs. 1-4 and 1-5) (See Fig. 1-7) (See Fig. 1-8) Volume Control 
(See Fig. 1-6) 
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1.1.1 The Keyboard 


SaaS eee 

The Apple IIc’s primary input device is the keyboard, shown in Figure 1-3. 

The keyboard has a 63-key typewriter layout with both uppercase and 
ASCII stands for American Standard Code = lowercase characters and can generate all 128 standard ASCII characters. A 
for Information Interchange. Table 4-2 lists —_ reget key, 80/40-column display selector switch, keyboard layout selector 


the ASCII character encoding for the ; «le. 
ance ide splined Won cevieatds sani - use light, and power light are also located on the front of the 


Appendix G lists the encoding for 
international keyboards. 


Figure 1-3. Front of Apple IIc With Standard USA Keyboard 


TULLLETELEEELLET ELE 
Reset Switch_—_f— 


80/40 Column Switch 


Keyboard Switch 


Disk-Use Light Power Light 


Table 1-1, on the next page, lists the characteristics of all Apple IIc 
keyboards and front panels. 


Features 


The Apple IIc keyboard has automatic repeat on all character keys. This 
means that if you hold the key down longer than about a second, the 
character it generates repeats until you let up the key. It also has two-key 
rollover, which means if you press a key before releasing the one you 
pressed before it, the second character enters the computer the same as 
though you had released the previous key first. (This is important for fast 
touch-typists. ) 
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The (G) and (6) keys are connected to 1-bit 
addresses in memory, described in 
Chapter 9. 


Chapter 2 describes the results of the 
various reset procedures. 


Table 1-1. Keyboard Specifications 


Number of keys: 63 

Character encoding: ASCII 

Number of codes: 128 

Features: Automatic repeat, two-key rollover 


Special function keys: [RESET], (G), (#6) 

Cursor movement keys: (-], [=], (+), [+], (RETURN), (DELETE ], 
Modifier keys: (CONTROL }, [SHIFT ], [CAPS LOCK], 
Front panel switches: 80/40 switch, keyboard switch 

Front panel lights: Power light, disk-use light 


Special Function Keys 


The Apple IIc keyboard has three special function keys: (RESET J, and two 
keys marked with apples—one outlined, (G), and one filled in, (eb). 


has a direct line to the 65C02 microprocessor’s RESET signal line 
(see Chapter 11): holding down while pressing causes 
the Apple IIc to restart processing with an internal firmware pro gram that 
puts the machine in a known state (see Chapter 2). 


You can restart the Apple IIc without turning the power off and back on 
again, by holding down both and (G] while pressing ( RESET}. 
Restarting this way is less stressful to the Apple IIc’s components than 
normal powerup. 


Cursor Movement Keys 


The Apple IIc keyboard has four cursor movement keys with arrows 
marked on them: left, right, down, and up. Three other keys can. also cause 
cursor movements: [RETURN ], (DELETE ], and (TAB). All seven of these keys 
generate ASCII control characters (see Table 4-2). It is up to the operating 
system or application program to interpret and act on the control codes that 
these keys generate. 


Chapter 1: Introduction 


The Monitor is a built-in program that 
performs some of the basic activities of the 
computer, such as retrieving and storing 
key codes as they come in, and clearing or 
updating the display screen. 


important! 


Modifier Keys 


Three special keys—{ CONTROL |, (SHIFT ], and [CAPS LOCK} generate no 
codes when pressed by themselves, but change the codes generated by 
other keys they are pressed in combination with. A fourth key, (ESC), 
generates a nonprinting control code that causes the Monitor to interpret 
certain subsequent keystrokes in a modified way. 


XO [CONTROL }, when pressed in combination with letter keys or certain 
other keys, produces ASCII control characters. Most of the control 
characters are invisible most of the time. 


Oo works the same on the Apple IIc as on an ordinary typewriter: it 
selects uppercase letters and the upper characters on the keys. 


0 [CAPS LOCK], in its down position, changes the letter keys to uppercase, 
but does not affect other keys. 


Oo is not a modifier key in the same sense as and (SHIFT |: 
you do not hold it down while pressing other keys. Rather, you press 
and it generates the ASCII escape (ESC) control character (key 
code $1B—see Table 4-2). When the key is pressed, many 
programs—including the built-in Monitor program—then interpret other 
specific keys as designating an escape sequence. 


The 80/40 Switch 


The 80/40 switch lets you specify whether a program should display 
information in 40 or 80 columns per line. The switch indicates 40-column 
display when in its down position, and 80-column display when in its up 
position. 


Not all programs check this switch. Even programs that do check the 
switch may do so only when the program first starts up. If that is the 
case, changing the switch position while the program is running will have 
no effect on the program’s display. (See Table 4-1.) 


The Keyboard Switch 


You use the keyboard switch to select for use one of the two keyboard 
layouts and screen character sets built into your Apple IIc. On USA versions 
of the Apple IIc, you select the standard Sholes keyboard layout (Figure 1-4) 
with the switch in the up position, and the Dvorak simplified layout (Figure 
1-5) with the switch in the down position. 


If you normally use the Dvorak keyboard layout, you can gently pry up the 
keys from the keyboard and rearrange and replace them in their Dvorak 
positions. 
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Figure 1-4. USA Standard or Sholes Keyboard (Keyboard Switch Up) 
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Figure 1-5. USA Simplified or Dvorak Keyboard (Keyboard Switch Down) 
Note: Shaded characters may be in different positions on some models. 
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Appendix G illustrates the keyboard 
layouts for both keyboard switch positions 
on several international versions of the 
Apple IIc. 
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The way programs co ntrol the speaker is 
described in Section 4.2. 


On international models, the keycaps indicate the character positions for 
the local keyboard layout, which is selected when the keyboard switch is 
down. When up, the keyboard switch selects the USA standard characters 
and key layout. 


Disk-Use and Power Lights 


The red disk-use light glows whenever the built-in disk drive’s motor is 
switched on. 


The green power light glows when the Apple IIc is turned on and normal 
power is present at the Apple IIc’s internal power supply. 


If the power light flashes on and off, turn off the computer immediately. 
Find out what caused the condition (such as a brownout or short circuit) 
and fix the problem before turning the computer on again. Above all, do 
not use the disk drive when the power light is flashing: this may damage 
the computer. 


1.1.2 The Speaker 


Sa | 

The red disk-use light glows whenever the built-in disk drive’s motor is 
switched on. The green power light glows when the Apple IIc is turned on 
and normal power is present at the Apple IIc’s internal power supply. 


The Apple IIc has a speaker in the bottom of the case, as shown in Figure 
1-6. The speaker lets Apple IIc programs produce a variety of sounds. There 
is also a volume control on the left side of the Apple IIc case, and a jack for 
connecting headphones or an external speaker. The jack accepts either 
one-channel (monaural ) or two-channel (stereo) plugs, although speaker 
output is monaural only. Inserting a plug disconnects the built-in speaker. 


Figure 1-6. Speaker, Volume Control, and Audio Output Jack 


Volume Control Knob 
Speaker (Inside) 


Audio Output Jack 
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1.1.3 The Built-in Disk Drive 
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The Apple Ilc’s built-in disk drive (Figure 1-7) is fully compatible with the 
Apple Disk IIc® that reads and writes 54-inch single-sided 35-track disks. 
The drive door is on the right side of the Apple IIc case. 


Figure 1-7. Built-in Disk Drive 


Disk Drive Door 


1.1.4 The Back Panel 


The back panel of the Apple IIc (Figure 1-8) has seven connectors and a 
main power switch. From left to right they are 


oO a9-pin D-type miniature connector for connecting hand controllers, a 
mouse, a joystick, or some other device (see Chapters 9 and 11) 


oO ad-pin DIN connector for serial input and output (port 2; normally for a 
modem) (see Chapters 7 and 11) 


o ald-pin D-type connector for video expansion (see Chapter 11) 
an RCA-type jack for a video monitor (see Chapter 11) 


oO a19-pin D-type connector for connecting one or more externall devices, 
such as intelligent disk drives (see Chapters 6 and 11) 


oO another 5-pin DIN connector for serial input and output (port 1; normally 
for a printer or plotter) (see Chapters 8 and 11) 


O aspecial 7-pin DIN connector for power input (see Chapter 11 ). 


O 


Before attaching cables to the Apple IIc back panel connectors, be sure to 
move the handle until it clicks into position for propping up the Computer. 
The handle should be down whenever the computer is running so that it 
can maintain proper cooling airflow. 
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The installation manuals for external devices contain instructions for 
connecting them to the Apple Ilc. 


Figure 1-8. Back P anel Connectors 
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Mouse and Hand Serial Port2 Video Expansion Handle Serial Port 1 Power 
Control Connector Connector Connector Connector Switch 
(See Figs. 11-37 (SeeFig. 11-30) (See Fig. 11-25) (See Fig. 11-30) 
and 11-42) 
Video Output External External Power 
Connector Disk Drive Connector 
(See Fig. 11-24) Connector (See Fig. 11-1) 


(See Fig. 11-26) 
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1.2 Inside of Machine 
eee 
Chapter 11] discusses in further detail these Figure 1-9 shows the main components inside the Apple IIc com puter. 
components and how they work. 


Figure 1-9. Inside of Machine 


Voltage 
Converter 


Built-in 
Disk Drive 


Main Logic Board 
(See Figure 1-11) 


Speaker 
(underneath) 


1.2.1 The Internal Voltage Converter 
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The built-in voltage converter operates from a 12 to 15 VDC input source, 
such as provided by the external power supply furnished with the Apple IIc 
(Figure 1-10). The voltage converter provides power for the logic board, 
built-in disk drive, one external disk drive, and the I/O signals available at 
the back panel. 
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Figure 1-10. Power Supply and Voltage Converter 


Internal Voltage Converter 


Power Switch 


Power Supply 


Complete specifications of the Apple IIc The voltage converter produces three different voltages: +5V, +12V, and 
power supply and voltage converter appear = ]2V. (Minus 5V, needed by some components in the Apple Ilc, is derived 
in Chapter Ll. from —12V on the main logic board.) It is a high-efficiency switching 


converter that protects itself and the rest of the Apple IIc against short 
circuits and other electrical mishaps. 


1.2.2 The Main Logic Board 


_—————————— eee 
The main logic board, which is mounted flat in the bottom of the Apple IIc’s 
case, has almost all the electronic parts of the computer attached to it. 


1.2 Inside of Machine i 


Figure 1-11 shows the main logic board and the most important integrated 
circuits (ICs) in the Apple IIc. They are the CPU (central process ing unit), 
RAM (random-access memory ), ROM (read-only memory) ICs for keyboard 


Firmware is program code that is storedin encoding, display character generation, and firmware, and the five custom 
ROM. It can be read and executed, but not —_— integrated circuits. 
changed. 

The processor is a 65C02 microprocessor. The 65C02 is a CMOS version of 


The specifications of the 65C02 are given in the 6502 used in other members of the Apple II family. It is an 8-bit 
Chapter 11; the 65002 instruction set is microprocessor with a 16-bit address bus. In the Apple IIc, the 65C02 runs at 
given in Appendix A. 1 MHz and performs up to 500,000 8-bit operations per second. 


Figure 1-11. Main Logic Board 
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The Applesoft language interpreter is 
described in the Applesoft Tutorial and 
the Applesoft BASIC Programmer's 
Reference Manual. 


Memory addressing: See Chapter 2. 


See Chapters 3 through 9. 


Chapter 11 discusses t_he functions of these 
integrated circuits in s ome detail. 
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The keyboard is scanned by an IC that generates matrix values for a ROM. 


The value of the ASCII code supplied by the ROM is latched at a specified 
memory location and is readable by programs. 


The character generator ROM converts ASCII character values to a form 
that the video display can use. 


The other ROM contains the Monitor, the Applesoft BASIC interpreter, 


enhanced video firmware, and other input/output firmware. The firmware 


that this ROM contains is described throughout this manual. 


Five of the large IC’s on the main logic board are custom-made for the 
Apple IIe: 


Oo The memory management unit (MMU) contains most of the logic that 


controls memory addressing in the Apple Ic. 


oO The input/output unit ([OU) contains most of the logic that controls 
the built-in input and output features of the Apple IIc. 


o The timing generator (TMG) generates all the system and 1/0 clock 
and timing signals from a 14-MHz oscillator. 

oO The general logic unit (GLU) performs the remaining required logic 
functions. 

O The disk controller unit, also known as the Integrated Woz 
Machine (IWM), is a single-chip version of the Apple Disk II controller 
card. It controls the built-in and external disk drives connected to the 
Apple IIc. 


1.2.3 The Other Circuit Boards 


aa ee ee eters) 

The Apple IIc contains other circuit boards that serve special purposes: a 
motor-speed control and read/write logic board for the disk drive, and a 
matrix board for detecting the position of keys pressed. This manual does 
not discuss these circuit boards. 


Adjustment of disk drive speed must be done by an authorized Apple 
service Center. Do not attempt to adjust the speed of your built-in disk 
drive. If you do, you may damage it and you will void your warranty. 


1.2 Inside of Machine 
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Chapter 2 Memory Organization and Control 
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This chapter introduces the Apple IIc’s processor, the 65C02, and the 
memory ranges and locations in the Apple IIc that have been set aside for 
special purposes. The last section of this chapter describes the reset 
routines, which restore the computer to a known state. 


2.1 The 65C02 Microprocessor 


a a kp a is el a ee en ey) 


Each of the other registers holds eight bits 
(one byte), so the 65C02 is called an 8-bit 
processor. 


Appendix A lists the instructions the 65C02 
can Carry out, their use, and their effects on 
the registers. For further information, 
consult the pertinent books listed in the 
Bibliography. 


The 65C02 is a general-purpose 8-bit CMOS microprocessor similar in 
operation to the 6502 used in other members of the Apple II family of 
computers. 


Figure 2-1 is a model of the 65C02 microprocessor’s register organization. 
Registers are fast-acting built-in storage areas where the processor performs 
and keeps track of its work. The 65C02 has one 16-bit register and five 8-bit 
registers. 


The 16-bit register is called the program counter (PC). It specifies the 
address in memory that contains the instruction the processor is currently 
carrying out. A 16-bit register can specify any one of 65,536 memory 
addresses, and so the 65C02 is said to have an address space of 65,536 
locations. 


The five 8-bit registers in the 65C02 are the following: 


oO The accumulator, or A register. The accumulator is like a desk top 
where the processor performs mathematical and logical operations on 
information. 

oO The index registers, X and Y. The processor uses these registers to 
modify the address where information is to be found or placed, and to 
pass information from one program to another. 


oO Astack pointer, or S register. The processor uses a 256-byte region of 
memory—page $01—as an area to stack up bytes for future use. The 
stack is empty when the computer is turned on. Several 65C02 
instructions either push (store) the contents of a register onto the stack, 
or pull (retrieve) a byte from the stack and place it in a register. The 
S register keeps track of the address of the byte in the stack that is 
currently ready for use. 

o A processor status register, called the P register. Seven of the eight 
bits of this register are used as flags to record the outcome of processor 
activities, and can be checked by later instructions to determ ine what 
has happened and what the processor should do next. 
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Figure 2-1. Internal Model of the 65C02 Microprocessor 
Copyright 1982, NCR Corporation. Used by permission of NCR Corporation, Dayton, Ohio. 
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2.2 Overview of the Address Space 


a 


Soft switches are described in Sections 2.4 
and 2.5. 


There are two other ROMs in the Apple IIc: 
one to generate characters corresponding to 
keystrokes (Section 11.7), and another to 
generate characters for display 

(Section 11.9). However, these ROMs are 
not addressable by the microprocessor. 


The Apple IIc’s 65C02 microprocessor can address 65,536 (64K) memory 
locations. All the Apple IIc’s RAM, ROM, and input and output (1/0) devices 
are accessed using addresses in this 64K address range. Some functions 
have the same addresses—but not at the same time. The Apple IIc controls 
its shared addresses by using soft switches. A soft switch is a memory 
location that controls some aspect of the computer’s operation when it is 
accessed. 


All input and output in the Apple IIc is memory mapped—that is, specific 
memory addresses (all in the $C0 page) are allocated to each I/O device. In 
this chapter, the I/O memory spaces are described simply as areas of 
memory. For details of the built-in I/O features and firmware, refer to the 
descriptions in Chapters 3 through 9. 


A contiguous block of 256 address locations in the 65C02’s address range is 
called a page. A 1-byte address counter or 8-bit register can specify 1 of 
256 different locations. Thus, page $00 consists of memory locations from 
0 through 255 (hexadecimal $00 through $FF); page $01 consists of 
locations 256 through 511 (hexadecimal $0100 through $01FF); and so on. 
In this manual, all page numbers are given in hexadecimal format. 


Note: The first two digits of a four-digit hexadecimal address are the 
page number. There are 256 pages of 256 bytes each in the address space. 
This kind of page is different from the display areas in the Apple IIc, 
which are sometimes referred to as Page 1 and Page 2. 


2.3 Memory Map and Memory Switching 


Figure 2-2 is a map of the Apple IIc’s memory address space and what the 
major blocks of addresses are used for. As you can see in the figure, 
addresses $C000 through $COFF contain hardware only, and 

addresses $C100 through $CFFF contain ROM only. At all other addresses 
there are two to five blocks of RAM or ROM locations. At any given time, 
only one block of RAM or ROM occupies each set of addresses. As described 
later in this chapter, soft switches in the hardware page control which 
blocks the processor is currently using. 
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Figure 2-2. Apple IIc Memory Map 
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2.3.1 Main RAM Addresses 
($0000-$BFFF and $D000-$FFFF) 


SS a a a a ae 

The area labeled Main RAM in Figure 2-2 is so-called because some or all of 
it is present in all models of the Apple II series of computers. The Apple IIc 
has 64K bytes of main RAM. 


2.3.2 Auxiliary RAM Addresses 

($0000-$BFFF and $D000-$FFFF) 
i | 

The Apple IIc has 64K of auxiliary RAM built in. Some or all of that range of 
auxiliary memory is present in an Apple Ile with one of the 80-column text 
cards installed (see Appendix F), but there is no auxiliary RAM in the 
Apple II or II Plus. 


A range of addresses in auxiliary RAM cannot be used simultaneously with 
the same range of addresses in main RAM; your programs must use the soft 
switches described in this chapter to select either main or auxiliary memory 
for any given range of addresses. 


2.3.3 ROM Addresses ($C100-$FFFF) 


ROM addresses contain the built-in Apple IIc firmware. Addresses $C100 
through $CFFF belong exclusively to ROM. Addresses $D000 through 
$FFFF are shared by ROM, main RAM, and auxiliary RAM; the selection 
techniques are described in Section 2.4.2. 


The Apple IIc’s built-in ROM pages $C1 through CF (addresses $C100 
through $CFFF) contain 1/0 firmware. The Apple IIc I/0 firmware is 
roughly divided among the built-in I/O devices as follows: 


oO Serial port 1 (RS-232 device) firmware entry points are on page $Cl. 
Much, but not all, of the firmware for the port is in the $C100 space. 

O Serial port 2 (communication device) firmware entry points are on 
page $C2. Much, but not all, of the firmware for the port is in the $C100 
space. 

oO Video output firmware entry points are on page $C3; the enhanced video 
firmware and miscellaneous I/O support routines occupy pages $C8 
through $CF. This is partly because there are no slots 8 through F on the 
Apple IIc and because the firmware takes up more than one page of 
firmware memory space. 
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The operation of the A_pplesoft interpreter 
firmware is described in the Applesoft 
BASIC Programmer's Reference 
Manual. 


Chapters 3 through 9 d escribe the 
Apple IIc’s input and owtput locations. 
Appendix B lists all of these locations in 
address order, rather than by function. 


Bit numbering in a byt e is explained in 
Appendix H. 


oO Mouse firmware entry points are on page $C4. 
o Disk I/O firmware entry points are on page $C6. 


Note: This correspondence of ports and entry points does not imply that 
all of each port’s firmware occupies a specific page. The Apple IIc I/O 
port firmware space is allocated in a way that provides the best possible 
performance in the available space. 


The ROM address range of pages $D0 through $FF contain the Applesoft 
BASIC interpreter and the Monitor firmware, allocated as follows: 


Oo Pages $D0 through $F7 (addresses $D000 through $F7FF) contain the 
Applesoft interpreter firmware. 


Oo Pages $F8 through $FF (addresses $F800 through $FFFF) contain the 
Monitor, described in Chapter 10. You can use some of the built-in 
Monitor routines to make input and output procedures in your 
assembly-language programs easier to write. These routines are 
described in Chapters 3 through 9. 


2.3.4 Hardware Addresses ($C000-$COFF) 
SSS en a a ee ee ee) 


The soft switches that the Apple IIc and your programs use to control the 
Apple IIc’s built-in input and output functions are all found in the $C0 
memory page (addresses $C000 through $COFF). In the same range of 
memory are the switches for selecting blocks of memory throughout the 
address space. This chapter describes the address space (memory ) 
Switches. 


The hardware functions of the switches in this page fall into five basic 
categories: 


oO Data inputs. The only data input is location $C000, where the low-order 
seven bits (bits 6 through 0) represent the keyboard key just pressed. 
(These data are guaranteed valid only when bit 7 = 1. ) 

oO Flag inputs. Most built-in input locations are single-bit flags in the 
high-order (bit 7) position of their respective memory addresses. Flags 
have only two values: on (greater than or equal to 128 or $80) or off (less 
than 128 or $80). 


The switch, hand controller (analog) and button inputs, and the 
keyboard strobe are examples of flag inputs. The locations for reading 
soft-switch states are also of this type. 
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O Strobe outputs. The clear keyboard strobe (Chapter 4) and paddle 
timer strobe (Chapter 9) outputs are controlled by memory loc ations. If 
your program reads the contents of one of these locations, then the 
function associated with that location will be activated. 


O Toggle switches. The Apple IIc has only one toggle switch: the speaker 
switch. A toggle switch has only one address assigned to it; each time 
you access it, it changes to its other state (on or off). 


Reading the speaker toggle at location $C080 clicks the speaker once. 
However, if you write to the speaker location, the microproces sor 
activates the address bus twice during successive clock cycles, causing 
the speaker toggle to end up in its original state before the speaker cone 
can move. Therefore, you should read, rather than write, to use this 
device. 


The processor cannot read the on/off status of the speaker switch. 


oO Soft switches. Soft switches are two-position switches turned on by 
accessing one address and turned off by accessing another address. Most 
of these switches have a third address associated with them for reading 
the state of the switch. 


There are eight soft switches that select different combinations of 
bank-switched memory (Section 2.4). Four of these eight switches 
require that your program read them twice in succession to activate 
them. 


2.4 Bank-Switched Memory 


22 


The memory areas described in this section are called bank-switched 
memory (Figure 2-3) because so many banks (ranges) of address es—one 
bank of ROM and up to four banks of RAM—occupy the same group of 
locations among the upper addresses of memory. Pages $00 and $01, at the 
low end of memory, are included here because the two sets of them—one in 
main RAM and one in auxiliary RAM—are controlled by the same switches 
as the high-address banks. The stack and zero page are switched this way 
so that system software running in the bank-switched memory space can 
maintain its own stack and zero page while it manipulates the 48K memory 
space (Section 2.5). 
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Figure 2-3. Bank-Switched Memory Map 
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All these memory banks are controlled by 
the soft switches described in Section 2.4.2. 
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2.4.1 Page Allocations 


Pages $00 and $01 are used by many of the 65C02 instructions. The ROM 
and RAM addresses in bank-switched memory are usually occupied by 
system software such as interpreters, compilers, and operating sy stems. 


Page $00 (One-Byte Addresses) 


Several of the 65C02 microprocessor’s addressing modes—for example, 
indirect addressing—require the use of addresses in page $00, or zero page. 
However, the Monitor, the interpreters, and the operating systems all make 
extensive use of page $00, too. One way to avoid conflicts is to use only 
those page-$00 locations not already used by these other programs. But 
there is another way. 


As you can see from Table B-1 in Appendix B, page $00 is pretty well used 
up, except for a few bytes here and there. Rather than trying to squeeze 
your data into an unused corner, you may prefer a safer alternative: turn off 
interrupts, save the contents of part of page $00, use that part, then restore 
the previous contents to page $00, restore interrupts to their previous state, 
and then pass control to another program. 


Page $01 (The 65C02 Stack) 


The 65C02 microprocessor uses page $01 as its stack—a place where it can 
store subroutine return addresses, in last-in, first-out sequence. P rograms 
can also use the stack for temporary storage of registers (via push and pull 
instructions). However, programs should use the stack carefully. 


Pages $D0-$FF (ROM and RAM) 


The memory address space from locations $D000 through $FFFF is used for 
both ROM and RAM. The 12K bytes of ROM in this address space contain 
the Monitor and the Applesoft BASIC interpreter. 


There are 16K bytes of main RAM in this 12K space, with two banks 
occupying the 4K of addresses from $D000 through $DFFF. The RAM is 
normally used for storing other languages such as Pascal, or operating 
systems such as ProDOS™. 


There are also 16K bytes of auxiliary RAM in this 12K space, again with 
double occupancy in the address range $D000 through $DFFF. 
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AWarning 


important! 


2.4.2 Using Bank Selector Switches 


SS a ee eee 
You switch banks of memory in the same way you switch other functions in 
the Apple IIc: by using soft switches. These soft switches do four things: 


o Select either RAM or ROM in this memory space. 


O Allow or inhibit (write-protect) writing to the RAM when RAM is 
selected. 


oO Select the first or second 4K-byte bank of RAM in the address space 
$D000 through $DFFF. 


oO Select either main RAM or auxiliary RAM. 


Do not use soft switches without careful planning. Careless switching 
between RAM and ROM is almost certain to have catastrophic effects on 
your program. 


Table 2-1 shows the addresses of the soft switches for selecting all allowed 
combinations of reading and writing in this memory space, and the 
addresses of the locations to read the switch settings. Figures 2-4 

through 2-10 illustrate how to select the combinations and what the 
resulting status of each switch is. 


To make sure you do not inadvertently remove write protection from 
bank-switched RAM, the four write-enable addresses require that you read 
them twice in succession (indicated by RR in Table 2-1). 


Because the AltZP switch shares the read keyboard address, you must write 
(W in Table 2-1) to its locations to change the switch setting. 


To find out which way a switch is set, read the appropriate location and 
then check bit 7 (shown as R7 in Table 2-1). If the bit is a 1, the answer to 
the question given in the table is affirmative. 


Note that there is no way to check whether write protection is on or off. 


You can’t read one RAM bank and write to the other; if you select either 
RAM bank for reading, you get that one for writing as well. However, you 
can read ROM and write RAM (Figures 2-5 and 2-6), which makes it easy 
to transfer firmware to bank-switched RAM if you want to use it with a 
program there. 
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Table 2-1. Bank Selector Switches 


Name Action Hex 
R $C080 
RR $C081 
R $C082 
RR $C083 
R $C088 
RR $C089 
R $CO8A 
RR $C08B 
RdBnk2 R7 $CO11 
RdLCRAM R77 $0012 
AltZP W $C008 
AltZP W $C009 
RdAltZP R7 $C016 


Dec 
49280 


4928] 


49282 


49283 


49288 


49289 


49290 


49291 


49169 


49170 


49160 


49161 


49174 
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Function 


Read RAM; no write; use $D000 
bank 2 


Read ROM; write RAM; use $D000 
bank 2 


Read ROM; no write; use $D000 
bank 2 


Read and write RAM; use $D000 
bank 2 


Read RAM; no write; use $D000 
bank 1 


Read ROM; write RAM; use $D000 
bank 1 


Read ROM; no write; use $D000 
bank 1 


Read and write RAM; use $D000 
bank 1 


Read whether $D000 bank 2 (1) or 
bank 1 (0) 


Read RAM (1) or ROM (0) 


Off: Use main bank, pagge $00 and 
page $01 


On: Use auxiliary bank, page $00 
and page $01 


Read whether auxiliary (1) or 
main (0) bank 


Figure 2-4. Read ROM 


Select memory: Select memory: 
W $C008 Turn off AltZP W $Cc009 Turn on AItZP 
R $0082 Read ROM, use bank 2* R $C082 Read ROM, use bank 2* 
or R_ $CO8A Read ROM, use bank 1* or R_  $CO8A Read ROM, use bank 1* 


Main RAM Auxiliary RAM 


Main RAM Auxiliary RAM 


Bank-Switched Memory 


Page$Si0 
PageS0O[ = seuss 
Read resulting status: Read resulting status: 
R7 $C016 Read AItZP; bit 7 = 0 R7 $C016 Read AItZP; bit 7 = 1 
R7 $C0O11 “Read Bank2; bit 7 = 1 or0 R7 $C011 *Read Bank2; bit 7 = 1 or 0 
R7 $C012 Read EnLCRAM; bit 7 = 0 R7 $C012 Read EnLCRAM; bit 7 = 0 


Legend: GF, Read memory {] Inactive memory Read, check bit 7 RR = Read twice in succession 


WW Write memory R Read Write 
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Figure 2-5. Read ROM, Write RAM, and Use First $D0 Bank 


Select memory: Select memory: 
W $C008 Turn off AlItZP W $c009 Turn on AltZP 
RR $C089 RR $C089 
ROM Main RAM Auxiliary RAM ROM Main RAM Auxiliary RAM 


Bank-Switched Memory 


Page $01 
Page $00 RO@. SOK We 
Read resulting status: Read resulting status: 
R7 $C016 Read AltZP; bit 7 = 0 R7 $C016 Read AItZP; bit 7 = 1 
R7 $C011 Read Bank2; bit7 = 0 R7 $C011 Read Bank2; bit 7 = 0 
R7 $C012 Read EnLCRAM; bit 7 = 0 R7 $C012 Read EnLCRAM; bit 7 = 0 


Legend: Vi = Read memory [ ] Inactive memory R7 = Read, check bit 7 RR = Read twice in succession 


WW = Write memory R Read W = Write 
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Figure 2-6. Read ROM, Write RAM, and Use Second $D0 Bank 
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Read resulting status: 


R7 $C016 Read AItZP; bit7 = 0 
R7 $C011 Read Bank2; bit 7 = 1 
R7 $0012 Read EnLCRAM; bit 7 = 0 


Legend: 


= Read memory [| 


Inactive memory 


WW = Write memory R Read 
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R7 = Read, check bit 7 


W = Write 


Select memory: 


Ww $c009 Turn on AltZP 
RR $C081 
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Read resulting status: 


R7 $C016 Read AItZP; bit 7 = 1 
R7 $0011 Read Bank2; bit 7 = 1 
R7 $0012 Read EnLCRAM; bit 7 = 0 


RR = Read twice in succession 
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Figure 2-7. Read RAM and Use First $D0 Bank 


Select memory: Select memory: 
W $C008 Turn off AItZP W $C009 Turn on AItZP 
R $C088 R $C088 
ROM Main RAM Auxiliary RAM ROM Main RAM Auxiliary RAM 


Bank Bank 
1 2 


Bank-Switched Memory 


Read resulting status: Read resulting status: 


R7 $C016 Read AItZP; bit 7 = 0 R7 $C016 Read AItZP; bit 7 = 1 
R7 $C011 Read Bank2; bit 7 = 0 R7 $C011 Read Bank2; bit 7 = 0 
R7 $C012 Read EnLCRAM; bit 7 = 1 R7 $C012 Read EnLCRAM; bit 7 = 1 


Legend: 2/7) = Read memory [ ] Inactive memory R7 = Read, check bit 7 RR = Read twice in succession 


WW = Write memory R Read W = Write 
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Figure 2-8. Read RAM and Use Second $D0 Bank 
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Read resulting status: 


R7 $C016 
R7 $0011 
R7 $C012 


Reead memory 


Write memory 


Ww $c009 Turn on AItZP 
R $c08o 
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Read resulting status: 


Read AItZP; bit 7 = 0 R7 $C016 Read AItZP; bit 7 = 1 
Read Bank2; bit 7 = 1 R7 $C011 Read Bank2; bit 7 = 1 
Read EnLCRAM,; bit 7 = 1 R7 $C012 Read EnLCRAM; bit 7 = 1 


Inactive memory Read, check bit 7 


Read Write 


RR = Read twice in succession 


2.4 Bank-Switched Memory 


31 


Figure 2-9. Read and Write RAM and Use First $D0 Bank 
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R7 $C016 Read AItZP; bit 7 = 0 R7 $C016 Read AItZP; bit 7 = 1 
R7 $C011 Read Bank2; bit 7 = 0 R7 $C011 Read Bank2; bit 7 = 0 
R7 $C012 Read EnLCRAM; bit 7 = 1 R7 $C012 Read EnLCRAM; bit 7 = 1 


Legend: GF, Read memory Inactive memory R7 = Read, check bit 7 RR = Read twice in succession 


WW Write memory Read W = Write 
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Figure 2-10. Read and Write RAM and Use Second $D0 Bank 
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Read resulting status: Read resulting status: 
FR7 $C016 Read AItZP; bit 7 = 0 R7 $C016 Read AItZP; bit 7 = 1 
R7 $C011 Read Bank2; bit 7 = 1 R7 $C011 Read Bank2; bit 7 = 0 
RR7 $0012 Read EnLCRAM; bit 7 = 1 R7 $C012 Read EnLCRAM; bit 7 = 1 


Legend: GH Re ad memory [] Inactive memory R7 = Read, check bit 7 RR = Read twice in succession 


WN Write memory R Read W = Write 
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2.5 48K Memory 


important! 


A buffer is any storage area set aside for 
one program or device to put information 
into and another to take information out of 
at a different time or rate. 


Refer to Appendix D and to the appropriate 
programmer and reference manuals for 
operating system use of page $08. 


Global storage refers to an area reserved 
for information that programs use in 
common. Vectors—the addresses of 
special routines—are examples of this kind 
of information. Section 2.6 discusses the 
global storage and vectors found on 

page $03. 
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The 48K memory space (actually, 47/4K) extends from location $0200 to 
location $BFFF (Figure 2-11) in both main and auxiliary RAM. The amount 
of storage available in this address space depends on what language or 
operating system you are using, and what video display needs your program 
has. 


2.5.1 Page Allocations 
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Most of the Apple IIc’s 48K RAM is available for storing your programs and 
data. However, a few RAM pages are reserved for the use of the Monitor 
firmware, the Applesoft BASIC interpreter, and whatever video display you 
may select. 


The system does not prevent your using these pages, but if your do use 
them, you must be careful not to disturb the system data they contain. 


Page $02 (The Input Buffer) 


The GetLn input routine (Section 3.2.3) uses page $02 as its keyboard-input 
buffer. The size of this buffer (256 bytes) sets the maximum size of input 
strings read by Applesoft or the Monitor. If you know that you won’t be 
typing any long input strings (more than, say, 30 characters), you can stcre 
temporary data at the upper end of page $02. 


Page $03 (Global Storage and Vectors) 


The Monitor and operating systems use parts of page $03 for global storage 
and vectors. Table 2-7, later in this chapter, shows the part of page $03 the 
built-in firmware uses. 


Pages $04-$07 (Text and Low-Resolution Page 1) 


The most often used display buffer is the text and low-resolution. graphics 
Page 1 (TLP1 in Figure 2-11), which occupies main memory pages $04 
through $07. It is not usable for program and data storage if you are using 
Monitor routines or Applesoft, or with almost any other program that uses 
text or low-resolution display. 
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Figure 2-11. 48K Memory Map 
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2.5 48K Memory 


See Chapter 5. 


See Section 3.4.6. 


Serial port 2: See Chapter 8. 


See Chapter 5. 
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AWarning 


Text and low-resolution Page 1X (TLP1X) is an identical display page 
occupying auxiliary memory pages $04 through $07. This pair of text and 
low-resolution graphics pages are used together to produce 80-column text 
display. 

There are 128 locations in pages $04 through $07 (64 in main RAM, 64 in 


auxiliary RAM) that are not displayed on the screen. These locations are 
called screen holes. 


| The screen holes are reserved for use by the built-in firmware. 


Pages $08-S$0B (Text and Low-Resolution Page 2) 


The second text and low-resolution graphics display buffer, TLP2, occupies 
main memory pages $08 through $0B. Most programs do not use Page 2 for 
displays, but TLP2 is there for display use if required. 


Text and low-resolution Page 2X (TLP2X) is an identical display buffer 
occupying pages $08 through $0B in auxiliary memory. 


Note that Apple IIc firmware does not provide a way to use the second pair 
of text and low-resolution graphics pages for 80-column text display. 


Page $08 (Communication Port Buffers) 


Serial port 2 uses the first half of auxiliary memory page $08 (ad dresses 
$0800 through $087F) as a keyboard input buffer, and the second half of the 
page (addresses $0880 through $08FF) as a serial input buffer. T hese 
buffers increase the data transfer rates possible with the serial 
communication port. Appendix E explains how to use these features. 


If your program does not use this page for buffers, it can use it as part 
of TLP2X. 


Pages $20-$3F (High-Resolution Page 1) 


The primary high-resolution graphics display buffer, called high-resolution 
Page 1 (HRP1), occupies the 32 memory pages from $20 through $3F 
(locations $2000 through $3FFF). If your program doesn’t use 
high-resolution graphics, this area is usable for programs or data. 


High-resolution Page 1X (HRP1X) is an identical display page occupying 
auxiliary memory pages $20 through $3F. 


The Apple IIc can display double-high-resolution graphics by interleaving 
HRP] and HRPI1X. 
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For more information about the display 
buffers, see Chapter 5. 


For details, refer to Section 2.5.4. 


Pages $40-$5F (High-Resolution Page 2) 


High-resolution Page 2 occupies main memory pages $40 through $5F 
(locations $4000 through $5FFF). Most programs use this area for program 
or data storage, but it is also available as a second high-resolution page. 


High-resolution Page 2X (HRP2X) occupies auxiliary memory pages $40 
through $5F. 


Apple IIc firmware provides high-resolution graphics routines for HRP1 and 
HRP2 only. Refer to the Applesoft BASIC Programmer’s Reference 
Manual. 


2.5.2 Using 48K Memory Switches 
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Two switches select main or auxiliary RAM in the 48K memory space: 
RAMRd determines which to use for reading, and RAMWrt determines 
which to use for writing. When these switches are on, they select auxiliary 
memory. When they are off, they select main memory. (This discussion 
assumes that the 80Store switch, used to control display memory, is off. ) 


Each switch has three locations assigned to it (Table 2-2): one to turn it on, 
one to turn it off, and a third to read its state. Because the memory locations 
for turning the switches on and off are shared with keyboard reading 
functions, you must write to these addresses to use them for memory 
switching. For each switch, you can read bit 7 at its third location to check 
whether the switch is on or off. If the switch is on, bit 7 is 1; if the switch is 
off, bit 7 is 0. Figures 2-12 and 2-13 illustrate how the switches work. 


Table 2-2. 48K Memory Switches 
Note: 80Store must be off to switch all memory in this range, including display 
memory (Table 2-6). 


Name Action Hex Dec Function 
RAMRd W $C002 49154 Off: Read main 48K RAM 
RAMRd W $C003 49155 On: Read auxiliary 48K RAM 


RdRAMRd ~~ R7 $C013 49171 Read whether main (0) or aux. (1) 


RAMWrt W $0004 49156 Off: Write to main 48K RAM 
RAMWrt W $0005 49157 On: Write to auxiliary 48K RAM 
RdRAMWrt = R7 $0014 49172 Read whether main (0) or aux. (1) 
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Figure 2-12. 48K RAM Selection: Split Pairs 


Select memory: Select memory: 
W $C000 Turn off 80Store W $C000 Turn off 80Store 
W $C002 Read from main memory W $C003 Read from auxiliary memory 
W $C005 Write to auxiliary memory W $C004 Write to main memory 
Main RAM Auxiliary RAM Main RAM Auxiliary RAM 
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48K RAM 


Read resulting status: Read resulting status: 


R7 $C018 Read 80Store; bit 7 = 0 R7 $C018 Read 80Store; bit 7 = 0 
R7 $0013 Read RAMRa; bit 7 = 0 R7 $C013 Read RAMRd; bit 7 = 1 
R7 $0014 Read RAMWrt; bit 7 = 1 R7 $C014 Read RAMW/rt; bit 7 = 0 


Legend: GY = Read memory = Inactive memory R7 = Read, check bit 7 


WW = Write memory Read W = Write 
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Figure 2-13. 483K RAM Selection: One Side Only 
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2.5.3 Transfers Between Main and Auxiliary Memory 


SSS ea ee ESSE SSS = 

If you want to write assembly-language programs that use auxiliary 
memory but you don’t want to manage the auxiliary memory yourself, you 
can use the built-in 48K RAM transfer routines. These routines (listed in 
Table 2-3) make it possible to move between main and auxiliary memory 
without having to manipulate the soft switches described in Section 2.5.2. 


The routines described below make it easier to use auxiliary memory, but 
they do not protect you from errors. You still have to plan your use of 
auxiliary memory to avoid catastrophic effects on your progrann. 


Table 2-3. 48K RAM Transfer Routines 


Name Action Hex Function 

MoveAux JSR $C311 Move data blocks between main and auxiliary 
48K memory 

XFer JMP $C314 Transfer program control between main and 
auxiliary 48K memory 


Transferring Data 


In your assembly-language programs, you can use the built-in routine 
named MoveAux to copy blocks of data from main memory to au_xiliary 
memory or from auxiliary memory to main memory. Before calling this 
routine, you must put the data addresses into byte pairs in page $00 and set 
or clear the carry bit to select the direction of the move. 


Don’t try to use MoveAux to copy data in bank-switched memory (page 
$00, page $01, or pages $D0 through $FF). MoveAux uses page $00 all 
during the copy. 


The pairs of bytes you use for passing addresses to this routine are 

called Al, A2, and A4, and they are used for parameter passing by several of 
the Apple IIc’s built-in routines. The addresses of these byte pairs are 
shown in Table 2-4. 


Put the addresses of the first and last bytes of the block of memory you 
want to copy into Al and A2. Put the starting address of the block of 
memory you want to copy the data to into A4. 
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Table 2-4. Parameters for MoveAux Routine 


Name Location Parameter Passed 
Carry 1 = Move from main to auxiliary memory 
( = Move from auxiliary to main memory 
AIL $3C Source starting address, low-order byte 
AlH $3D Source starting address, high-order byte 
A2L $3E Source ending address, low-order byte 
A2H $3F Source ending address, high-order byte 
A4L $42 Destination starting address, low-order byte 
A4H $43 Destination starting address, high-order byte 
X,Y,A These registers are preserved. 


The MoveAux routine uses the carry bit to select the direction to copy the 
data. To copy data from main memory to auxiliary memory, set the carry bit 
(SEC instruction); to copy data from auxiliary memory to main memory, 
clear the carry bit (CLC instruction). 


When you make the subroutine call to MoveAux, the subroutine copies the 
block of data as specified by the A register and the carry bit. When it is 
finished, the accumulator and the X and Y registers are just as they were 
when you called it. 


Transferring Control 


You can use the built-in routine named XFer to transfer control to and from 
program segments in auxiliary memory. You must set up three parameters 
before using XFer: the address of the routine you are transferring to, the 
direction of the transfer, and which page $00 and stack you want to use 
(Table 2-5). 
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Table 2-5. Parameters for XFer Routine 


Name Location Parameter Passed 
Carry 1 = Transfer from main to auxiliary memorvy 
Q = Transfer from auxiliary to main memorcy 
Overflow 1 = Use page $00 and stack in auxiliary mernory 
0 = Use page $00 and stack in main memory 
$03ED Program starting address, low-order byte 
$03EE Program starting address, high-order byte 
X,Y, A These registers are preserved. 


Put the transfer address into the two bytes at locations $03ED and $03EE, 
with the low-order byte first, as usual. The direction of the transfer is 
controlled by the carry bit: set the carry bit to transfer to a program in 
auxiliary memory; clear the carry bit to transfer to a program in main 
memory. 


Use the overflow bit to select which page $00 and stack you want to use: 
clear the overflow bit to use the main memory; set the overflow bit (cause 
an overflow condition) to use the auxiliary memory. 


After you have set up the parameters, pass control to the XFer routine by a 
jump instruction, rather than a subroutine call. 


It is your responsibility as the programmer to save the current stack 
pointer before using XFer and to restore it after regaining control. Failure 
to do so will cause program errors. Refer to Appendix E for instructions on 
how to do this. 
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See Chapter 5 for a dis cussion of display 
pages. 


2.5.4 Using Display Memory Switches 
>> Sen ee eS SS 


Section 2.5.2 discusses how to select main or auxiliary RAM for the 

48K memory space. However, under many circumstances your program 
may want to control reading and writing to display pages separately. The 
switches discussed in this section override the effects of RAMRd and 
RAMWrt for display pages only. 


Three switches are involved in the display page selection process. Each of 
them has three locations assigned to it: one to turn it on, one to turn it off, 
and a third to read its state (Table 2-6). One of the switches, 80Store, shares 
its on and off addresses with a keyboard reading function. As a result, your 
program must write to these locations to turn the switch on and off. 


Table 2-6. Display Memory Switches 


Name Action Hex Dec Function 

80Store W $C000 49152 Off: RAMRd and RAMWrt 
determine RAM locations. 

80Store W $C001 49153 On: Page2 switches between TLP1 
and TLP1X, and (if HiRes on) 
between HRP1 and HRP1X. 

Rd80Store 7 $C018 49176 Read whether 80Store on (1) or off 
(0) 

Page2 R $0054 492386 Off: Select TLP1 and HRP1 

Page2 R $C055 49237 On: If 80Store off, switch to TLP2, 


and (if HiRes on) to HRP2. If 
80Store on, switch to TLP1X, and 


(if HiRes on) to HRPIX. 

RdPage2 R7 $C01C 49180 Read whether Page2 on (1) or 
off (0) 

HiRes R $C056 49288 _—Off: Display text and low-resolution 
page 

HiRes R $C057 49239 On: Display high-resolution pages; 


make Page2 switch between 
high-resolution pages 


RdHiRes R7 $CO1D 49181 Read whether HiRes on (1) or 
off (0) 
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Table 2-6—continued. Display Memory Switches 


Name Action Hex Dec Function 


IOUDis W $CO7E 49278 On: Disable IOU access for 
addresses $CO58 to $CO5 F; enable 
access to DHiRes switch* 


IOUDis W $CO7F 49279 Off: Enable IOU access for 
addresses $CO58 to $CO5F; disable 
access to DHiRes switch* 


RdIOUDis R77 $CO7E 49278 Read JOUDis switch (1=off)t 


DHiRes R/W $CO5E 49246 On: (If IOUDis on) turn on 
double-high resolution 


DHiRes R/W $CO5F 49247 — Off: (If IOUDis on) turn off 
double-high resolution 


RdDHiRes = R7 SCO7F 49279 Read DHiRes switch (1= on)t 


* The firmware normally leaves IOUDis on. 
+ Reading or writing any address in the range $CO70-$CO7F also triggers the paddle timer 
and resets VBlInt (see Chapter 9). 


For each switch, you can read bit 7 at its third location to check whether 
the switch is on or off. If the switch is on, bit 7 is 1; if the switch is off, bit 7 
is Q, 


Here is how these switches work for reading and writing: 


o If HiRes is off, then Page2 switches between text and low-resolution 
graphics pages (TLP) only. If HiRes is on, then Page2 switches between 
TLP and high-resolution graphics pages (HRP). 

Oo If 80Store is off, RAMRd and RAMWrt (Table 2-2) determine whether 
main or auxiliary RAM locations are used. Page2 selects pages for display 
(Chapter 5), but not for reading and writing. 

oO If 80Store is on, it overrides RAMRd and RAMWrt with respect to the 
display pages selected by HiRes and Page2 (Figures 2-14 and 2-15). 
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| Figure 2-14. Page2 Selections With 80Store On and HiRes Off 
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Figure 2-15. Page2 Selections With 80Store On and HiRes On 
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2.6 The Reset Routine 


A procedure called the reset routine (Figure 2-16) puts the Apple IIc into a 
known state when it has just been turned on or when you hold down 

while pressing (RESET }. The reset routine puts the Apple IIc into 
its normal operating mode and restarts the program indicated at 

locations $03F2 and $03F8 (Table 2-7). 


When you initiate a reset, hardware in the Apple IIc sets the 
memory-controlling soft switches to normal: main ROM and RAM are 
enabled, auxiliary RAM is disabled and the bank-switched memory space is 
set up to read from ROM and write to RAM, using the second bank at $D000. 


Figure 2-16. Reset Routine Flowchart 


Power On (G) - (CONTROL) - (RESET CONTROL ) - (RESET 
(Cold Start) (Forced Cold Start) (Warm Start) 
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— Read ROM, write main bank- 
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— Display 40-column text page $01, ; : 
primary character set, normal variables intact 
— Enable access to DHiRess switch 
— I/O links: keyboard input (KSW), 
— Ports: startup settings Do what it 
— Clear keyboard strobe No Other says to do 
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The reset vector validity check is described 


in Section 2.6.4. 
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Table 2-7. Page $03 Vectors 


Vector Address 


$03F0 (1008) 
$03F1 (1009) 


$03F2 (1010) 
$03F3. (1011) 


$03F4 (1012) 


$03F5 (1013) 
$03F6 (1014) 
$03F7 (1015) 


$03F8 (1016) 
$03F9 (1017) 
$03FA (1018) 


$03FB (1019) 
$03FC (1020) 
$03FD (1021) 


$03FE (1022) 
$03FF (1023) 


Vector Function 


Address of the subroutine that handles BRK requests 
(normally $59, $FA) 


Reset vector (see text) 


Power-up byte (see text) 


Jump instruction to the subroutine that handles Applesoft 
&-commands (normally $4C, $58, $FF) 


Jump instruction to the subroutine that handle s user 
CONTROL-Y commands 


Jump instruction to the subroutine that handles 
nonmaskable interrupts (not used on Apple IIc ) 


Interrupt vector (address of the subroutine that handles 
interrupt requests ) (Appendix E) 


The reset routine sets the display-controlling soft switches to dis play 


40-column text Page 1 using the primary character set, then sets the display 
window equal to the full 40-column display, puts the cursor at the bottom of 
the screen, and sets the text display format to normal. 


The reset routine also sets the keyboard and display as the standlard input 
and output devices (Chapter 3). It masks mouse interrupts and sets mouse 
defaults (Table 9-1). Finally, it enables DHiRes switch access (by turning on 
IOUDis), clears the keyboard strobe, and sounds the speaker. 


The Apple IIc has three types of reset: power-on reset, also called cold-start 
reset; warm-start reset; and forced cold-start reset. The procedure described 
above is the same for any type of reset. What happens next depends on the 
reset vector. The reset routine checks the reset vector to determine whether 
it is valid or not. If the reset was caused by turning the power on , the vector 
will not be valid, and the reset routine will perform the cold-star& procedure. 
If the vector is valid, the routine will perform the warm-start procedure. 
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Important! 


2.6.1 The Cold-Start Procedure (Power On) 


If the reset vector is not valid, either the Apple IIc has just been turned on 
or something has caused memory contents to be changed. The reset routine 
clears the display and puts the string Apple© IIc at the top of the 
display. It loads the reset vector and the validity-check byte, then initiates 
the startup routine that resides in the disk controller firmware. The 
bootstrap routine then loads whatever operating system resides on the disk 
in the built-in drive. When the operating system has been loaded, it displays 
other messages on the screen. If there is no disk in the disk drive, the drive 
motor keeps spinning for a brief time. Then the firmware shuts it off and 
displays the message Check Disk Drive atthe bottom of the screen. 


If you press again before the startup procedure is 
completed, the reset routine continues without using the disk, and passes 
control to the Applesoft BASIC interpreter. 


2.6.2 The Warm-Start Procedure (CONTROL-RESET) 
SS ee SES eee ee ee eel 
Whenever you press when the Apple IIc has already 
completed a cold-start reset, the reset vector is still valid and it is not 
necessary to reinitialize the entire system. The reset routine simply uses the 
vector to transfer control to the program it points to, which at power-up is 
the Applesoft interpreter. 


If the vector does point to the Applesoft interpreter, your Applesoft program 
and variables are still intact. If you are using DOS or ProDOS, that operating 
system is the resident program and it restarts the BASIC interpreter you 
were using when you pressed [CONTROL }{ RESET ]. 


A program residing only in bank-switched RAM cannot use the reset 
vector to regain control after a reset, because upon reset the hardware 
selects the ROM for reading in the bank-switched memory space. 


2.6.3 Forced Cold Start (OPEN APPLE-CONTROL-RESET) 


If a program has set the reset vector to point to its own warm-start address, 


as described below, pressing causes transfer of control 
to that program. If you want to stop such a program without turning the 
power off and on, you can force a cold-start reset by holding down 


CONTROL ] and (G], then pressing and releasing [RESET ]. 
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important! 


UniDisk 3.5 


When you want to stop a program unconditionally—for example, to start 
up the Apple IIc with some other program—you should use the forced 


cold-start reset, [(G } CONTROL }{ RESET ], instead of turning the power off 
and on. 


You must hold {G] down until the built-in drive starts to spin. If you 
release [G] before the drive starts to spin, the Apple IIc drops into BASIC 
instead of rebooting. 


The forced cold-start reset works as follows. First, it destroys the program 
or data in memory by writing two bytes of arbitrary data into each page of 
main RAM. The two bytes that get written over in page $08 are th.e ones 
that contain the reset vector. The warm-start reset routine finds the error, 
and so performs a normal cold-start reset. 


Note that if you press both (G] and (#] during power-up or 


CONTROL }{ RESET |, built-in exercise code is executed. This code is for 
production and has no end-user value. 


2.6.4 The Reset Vector 


a: I SE ee eee | 

The cold-start reset routine stores the starting address of the built-in 
Applesoft interpreter, low-order byte first, in the reset vector addwess at 
locations $08F2 and $08F8. It then stores a validity-check byte, also called 
the power-up byte, at location $03F4. The validity-check byte is computed 
by performing an exclusive-OR of the second byte of the vector w ith the 
constant 165 (hexadecimal $A5). Each time you reset the Apple Ic, the 
reset routine uses this byte to determine whether the reset vector is still 
valid. 


You can change the reset vector so that the reset routine will trarasfer 
control to your program instead of to the Applesoft interpreter. For this to 
work, you must also change the validity-check byte to the exclusive-OR of 
the high-order byte of your new reset vector with the constant 16 5 ($A5). If 
you fail to do this, then the next time you reset the Apple IIc, the reset 
routine will determine that the reset vector is invalid and perform a 
cold-start reset, eventually transferring control to the disk bootstrap routine 
or to Applesoft. 


There is a subroutine that generates the validity-check byte for the current 
reset vector. This subroutine, called SetPWRC, is at location $F B6F. When 
your program finishes, it can return the Apple IIc to normal operation by 
restoring the original reset vector and again calling the subroutine to fix up 
the validity-check byte. 
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Chapter 3 Introduction to Apple IIc 1/0 


This chapter is an introduction to the built-in I/O capabilities of the 
Apple Ilc. It outlines 


oO standard I/O links and their functions 
o 1/0 firmware protocols 

oO dedicated memory storage locations 

o direct I/O. 


The next six chapters discuss these capabilities in detail. 


3.1 The Standard I/O Links 


og 


You can use some of the routines in the Apple IIc’s firmware for your own 
programs. This can save you both program space and the time and effort of 
writing all your own I/O routines. 


To use the built-in firmware routines, your program must perform a JSR to 
the routine’s entry address. The called routine then performs an indirect 
jump through an address stored somewhere in RAM and begins executing. 
When the routine has finished doing its work, it returns (with an RTS) to 
your program at the first instruction following the JSR used to call the 
routine. Memory locations used for transferring control to other subroutines, 
such as the indirect jump’s address used by the character I/O routine, are 
sometimes called vectors. In this manual, the locations used for transferring 
control to the Apple IIc’s I/O subroutines are called the I/O links. 


In an Apple IIc running without an operating system, each I/O link 
normally contains the address of the standard input or output subroutine. 
An operating system will typically place addresses of its own I/O routines 
in these link locations instead. 


By calling the I/O subroutines that then jump to the routines pointed to by 
the link addresses instead of calling the standard subroutines directly, you 
ensure that your program will work properly with other software, such as 
the operating system or a device driver. The I/O links contain the addresses 
of KeyIn and COut1 if the enhanced video firmware is off (when the display 
shows a flashing checkerboard cursor), and of C3KeylIn and C3COut! if that 
firmware is on (when the display shows an inverse solid cursor). 


The standard I/O links are two pairs of locations in the Apple IIc RAM in 
the range $36 through $39 that are used for controlling character input and 
output. 
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The Monitor is discussed in Chapter 10. 
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Note: Not all operating systems use the standard I/O links. For example, 
Apple Pascal does not use them. 


The link at locations $36 and $387 is called CSW, for character output 
switch. Individually, location $36 is called CSWL (CSW low) and 
location $37 is called CSWH (CSW high). This link holds the starting 
address of the subroutine the Apple IIc is currently using for 
single-character output. This address is normally $FDF0, the address of 
routine COutl1. 


When you issue either a PR#n from BASIC or an n CONTROL-P from the 
Monitor, the Apple IIc changes this link address to the first address in the 
ROM space allocated to port n. That address has the form $Cn00. 
Subsequent calls for character output are thus transferred to the firmware 
starting at that address. When it has finished, the firmware executes an 
RTS (return from subroutine) instruction to return control to the calling 
program. Sometimes a PR#n will cause both input and output switches to 
be changed (as in the 80-column firmware). 


A similar link at locations $38 and $39 is called KSW, for keyboard input 
switch. Individually, location $38 is called KSWL (for KSW low) and 
location $39 is called KS WH (KSW high). This link holds the starting 
address of the routine currently being used for single-character input— 
normally $FD1B, the starting address of the standard input routine KeyIn. 


When you issue an IN#n command from BASIC or an n CONTROL-K from 
the Monitor, the Apple IIc changes the link address in KSW to $Cn00, the 
beginning of an I/O firmware subroutine. Subsequent calls for character 
input are thus transferred to that firmware. The firmware puts the input 
character, with its high bit set, into the accumulator and executes an RTS 
(return from subroutine) instruction to return control to the program that 
requested input. 


When a disk operating system (DOS or ProDOS) is running, one or both of 
the standard I/O links hold addresses of the disk operating system’s input 
and output routines. The operating system has internal locations that hold 
the addresses of the currently active character input and output routines. 


If a program that is running with DOS or ProDOS changes the standard 
link addresses, either directly or via IN# and PR# commands, the 
operating system may be disconnected from the system. To avoid this 
problem, when programming in BASIC you should always issue an empty 
PRINT statement (to be sure that what follows begins a new line) before 
issuing the PRINT statement containing CONTROL-D and the IN# or PR# 
command. 
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Refer to the section on input and output 
link addresses in the operating system 
manuals for further details. 


After changing either CSW or KSW, your assembly-language programs 
running under DOS should call the subroutine at location $03EA-. This 
subroutine transfers the link address to a location inside the operating 
system and then restores the operating system link address in the standard 
link location. 


3.2 Standard Input Features 


Te a ee ee eee) 


GetLn also provides on-screen editing 
features: See Section 3.2.5. 


o4 


The Apple IIc’s firmware includes two different subroutines for reading 
from the keyboard, RdKey (for read key) and GetLn (get line). 


RdKey calls the current character input routine (that is, the one whose 
address is stored at KSW). This is normally KeylIn or C3KeylIn, which 
accepts one character from the keyboard. GetLn accepts a sequence of 
characters terminated with a carriage return. Thus GetLn allows 
line-oriented input using the current input routine. 


3.2.1 RdKey Subroutine 


————=SSSS eee ee 

A program can get a character from the keyboard by making a swbroutine 
call to RdKey at memory location $FDOC. RdKey passes control via the 
input link KSW to the current input subroutine, which is normally KeyIn. 


RdKey displays a cursor at the current cursor position, which is 
immediately to the right of whatever character you last sent to the display 
(normally by using the COut routine, described below). 


3.2.2 Keyln Subroutine 


——SSS————EE—S ae eee) 

KeylIn is the standard input subroutine. When your program calls it, KeyIn 
displays a cursor, waits until someone presses a key, then inserts the ASCII 
code of the Key just pressed in the accumulator and returns to the calling 
program. 


If the enhanced video firmware is inactive, KeyIn displays a curs or by 
alternately storing a checkerboard block in the cursor location, storing the 
original character, then storing the checkerboard again. If the firrmware is 
active, C3Keyln places a block cursor on the screen by inverting (swapping 
black for white) the character at the cursor position. 
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Section 3.2.5 describes other features of 
GetLn. 


KeylIn also generates a random number. While it is waiting for the user to 
press a key, KeyIn repeatedly increments the 16-bit number in memory 
locations $4E and $4F. This number keeps increasing from 0 to $FFFF 
(65535), then starts over again at 0. The value of this number changes so 
rapidly that it is very difficult to predict what it will be after a key is 
pressed. A program that reads from the keyboard can use this value as a 
random number or as a seed for a pseudo-random number routine. 


3.2.3 GetLn Subroutine 


Programs often need strings of characters as input. While you could call 
RdKey repeatedly to get several characters from the keyboard, there is an 
easier way to do it. The routine that you want to use in this case is named 
GetLn, and it starts at location $FD6A. Using repeated calls to RdKey, 
GetLn accepts characters from the standard input subroutine—usually 
KeyIn—and puts them into the input buffer located in the memory page 
from $0200 to $02FF. GetLn also provides you with some basic on-screen 
editing and control features. 


The first thing GetLn does when you call it is to display a prompt. The 
prompt indicates to the user that the program is waiting for input. Different 
programs use different prompt characters, helping to remind the user which 
program is requesting the input. Table 3-1 shows the prompt characters 
used by different programs on the Apple IIc. 


GetLn uses the character stored at memory location $38 as the prompt 
character. In an assembly-language program, you can change the prompt to 
any character you wish. In BASIC, changing the prompt character has no 
effect, because both BASIC interpreters and the Monitor restore it each time 
they request input from the user. 


Table 3-1. Prompt Characters 


Prompt 

Character Program Requesting Input 

? User's BASIC program (INPUT statement) 
] Applesoft BASIC (Appendix D) 

> Integer BASIC (Appendix D) 


Firmware Monitor (Chapter 10) 


3.2 Standard Input Features Do 
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Note: Applesoft uses GetLn1 ($FD6F) when a program is executing. 
GetLn1 does not print a prompt. 


As the user types each character, GetLn sends the character to tlhe standard 
output routine—normally COutl1—which displays it at the current cursor 
position and then advances the cursor to indicate the next character 
position. Control characters echoed by GetLn are not executed. 


GetLn stores the characters in its buffer, starting at memory location $0200 
and using the X register to index the buffer. GetLn continues to accept and 
display characters until the user presses (or to 
cancel the line). Then it clears the remainder of the line the cursor is on, 
stores the carriage-return code to mark the end of the buffer, places the 
cursor at the beginning of the next line, and returns. 


The maximum line-length that GetLn can handle is 255 characters. If the 
user types more than this, GetLn sends a backslash (\) and a carriage 
return to the display, cancels the line it has accepted so far, and starts over. 
To warn the user that the line is getting full, GetLn sounds a bell (tone) at 
every keypress after the 248th. 


| Note: The Applesoft interpreter accepts only 239 characters. 


3.2.4 Escape Codes With GetLn 


GetLn has many special functions that you invoke by typing escaape codes 
on the keyboard. An escape code is sent by pressing [ESC], releas ing it, and 
then pressing some other key, as shown in Table 3-2. 


Be sure to release right away. If you hold it too long, the auto-repeat 
mechanism begins, which may cancel the [Esc]. 


Table 3-2. Escape Codes With GetLn 


Escape Code Function 

[e} Clears the window and homes the cursor (places it 
in the upper-left corner of the screen), them exits 
from escape mode 

Moves the cursor right one line and exits from 

or (a) escape mode 

Moves the cursor left one line and exits fro m 

or [b) escape mode 
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Table 3-2—continued. Escape Codes With GetLn 


Escape Code 


or (ESC ]}{c] 


[esc}[D] 
or (esc }(d) 


(esc }[E) 
or [esc }[e] 


or [esc }[F] 


[esc }[1) 
or (Esc) (i) 
or Cesc J+) 


or (Esc }{i] 
or [esc }{+] 


(Esc }[K] 
or [ESC }[k] 
or [Esc }[=} 


(esc }(M] 
or (ESC }[m] 
or (esc }{4) 


[esc }[4) 


[ESC || CONTROL }/D | 


(ESC } (CONTROL }{E} 
[ESC] (CONTROL }{Q_ 


* Cursor-control Key: see text. 


Function 


Moves the cursor down one line and exits from 
escape mode 


Moves the cursor up one line; exits from escape 
mode 


Clears to the end of the line; exits from escape 
mode 


Clears to the bottom of the window; exits from 
escape mode 


Moves the cursor up one line; remains in escape 
mode* 


Moves the cursor left one space; remains in escape 
mode* 


Moves the cursor right one space; remains in 
escape mode* 


Moves the cursor down one line; remains in escape 
mode* 


Switches to 40-column mode; sets links to 
C3KeylIn and C8COut1; restores normal window 
size (Table 3-5); exits from escape modet 


Switches to 80-column mode; sets links to 
C3Keyln and C3COutl; restores normal window 
size (Table 3-5); exits from escape modet 


Disables control characters; only carriage return, 
line feed, bell, and backspace have an effect when 
printed 


Reactivates control characters 


Deactivates the enhanced video firmware; sets 
links to KeyIn and COut1; restores normal window 
size (Table 3-5); exits from escape modet 


t This code functions only when the enhanced video firmware is active. 


3.2 Standard Input Features 


For an introduction to editing with these 
features, refer to the Applesoft Tutorial. 
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In escape mode, you can keep using the arrow keys and the cursor 
movement keys {1}, (J, (K], and (m] without pressing again. This 
enables you to perform repeated cursor moves by holding down the 
appropriate key. 


When GetLn is in escape mode, it displays an inverse plus sign as the 
cursor. You leave escape mode by typing any Key other than a cursor 
movement key. 


Note: The escape codes with the arrow keys are the standard. cursor 
movement keys on the Apple IIc. The escape codes with (1), (J), (k], 
and (m]are the standard cursor movement keys on the Apple II and 
II Plus, and are present on the Apple IIc for compatability. 


Escape sequences can be used in the middle of an input line to change the 
appearance of the screen. They have no effect on the input line. 


3.2.5 Editing With GetLn 


Sa Se a ee ree 

Subroutine GetLn provides the standard on-screen editing features used by 
the BASIC interpreters and the Monitor. Any program that uses GetLn for 
reading the keyboard has these features. 


Cancel Line 


Anytime you are typing a line, pressing causes GetLn to 
cancel the line. GetLn displays a backslash ( \ ) and issues a carriage 
return, then displays the prompt and waits for you to type a new line. GetLn 
takes the same action when you type more than 255 characters, as 
described above. 


Backspace 


When you press (= ] (or [CONTROL }{H]), GetLn moves its buffer pointer 
back one space, effectively deleting the last character in its buffer. It also 
sends a backspace character to routine COut, which moves the c ursor back 
one space. If you type another character now, it replaces the character you 
backspaced over, both on the display and in the line buffer. 


Each time you press (= ], it moves the cursor left and deletes another 
character, until you are back at the beginning of the line. If you then press 
one more time, you have effectively canceled the line, and GetLn issues 
a carriage return and displays the prompt. The cursor moves even if the 
deleted character is an invisible control character. Thus it is possible for 
screen alignment and buffer alignment to be different. 
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See Section 3.2.4. 


Retype 


[=] (or (CONTROL }{U}) has a function that is complementary to the 
backspace function. When you press (= ]}, GetLn picks up the character 
under the cursor just as if it had been typed on the keyboard. You can use 
this procedure to pick up characters that you just deleted by backspacing 
across them. You can use the backspace and retype functions with the 
cursor-motion functions to edit data on the display. 


3.3 Standard Output Features 


The standard output routine is named COut (character output). COut 
normally calls COut1 or C3COut1, which sends one character to the display, 
advances the cursor position, and scrolls the display when necessary. 
COutl and C38COutl restrict their use of the display to an active area called 
the text window, described in Section 3.3.5. 


3.3.1 COut Subroutine 


——————— eS Se eae 

Your program makes a subroutine call to COut at memory location $FDED 
with a character in the accumulator. COut then passes control via the 
output link CSW to the current output subroutine, normally COut1 or 
C3COutl, which takes the character in the accumulator and writes it out. If 
the accumulator contains an uppercase or lowercase letter, a number, or a 
special character, COut1l or C3COut!1 displays it; if the accumulator contains 
a control character, COutl or C3COut! either performs one of the special 
functions described below or ignores the character. 


Each time you send a character to COut1 or C3COutl, it displays the 
character at the current cursor position, replacing whatever was there, and 
then advances the cursor position one space to the right. If the cursor 
position is already at the right-hand edge of the window, COut1 or C3COut1 
moves it to the leftmost position on the next line down. If this would move 
the cursor position past the end of the last line in the window, COut1 or 
C38COutl scrolls the display up one line and sets the cursor position at the 
left end of the new bottom line. 
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AWarning 


Escape codes are described in Section 3.2.4. 
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The cursor position is controlled by the values in memory locations $24 

and $25. These locations are named CH, for cursor horizontal, and CV, for 
cursor vertical. COut1 and C3COut! do not display a cursor, but the input 
routines described above do, and they use this cursor position. However, 
changing CV directly does not change the cursor’s vertical position until the 
next carriage return or reaching the end of the current line causes a call to 
VTab (for setting the base address within windows). If some other routine 
displays a cursor, it will not necessarily put it in the cursor position used by 
COut1 or C38COutl. 


When the video firmware is set for 80-column display, the value of CH is 
kept at 0 and the true horizontal position is stored at $057B. When the 
80-column video firmware is active, use $057B instead of CH. 


3.3.2 Control Characters With COut1 


COutl does not display control characters. Instead, the control characters 
listed in Table 3-3 are used to initiate some action by the firmware. Other 
control characters are ignored. Most of the functions listed here can also be 
invoked from the keyboard, either by typing the control character listed or 
by using the appropriate escape code. The stop-list function, des cribed 
separately, can only be invoked from the keyboard. 


Table 3-3. Control Characters With COutl 


Control ASCII Apple IIc 
Character Name Name Action Taken by COut1 
CONTROL-G BEL bell Produces a 1000-Hz tone for 
0.1 second 
CONTROL-H BS backspace Moves cursor position one space to 
the left; from left edge of window, 
moves to right end of line above 
CONTROL-J LF line feed Moves cursor position down to next 
line in window; scrolls if needed 
CONTROL-M CR return Moves cursor position to left end of 


next line in window; scrolls if needed 
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Escape codes are descr ibed in Section 3.2.4. 


3.3.3 Control Characters With C3COut1 


When the 80-column firmware is active, COut calls C3COut1 instead of 
COut1 for character output. C3COut1 does not display control characters, 
but you can use some control characters to control some of what the routine 
does. All other control characters are ignored. 


The control characters listed in Table 3-4 are used to initiate some action by 
the firmware. Except for the stop-list function ((CONTROL HS }) you can 
send control characters to C3COut1 either from a program or from the 
Apple IIc’s keyboard. The stop-list function can only be invoked from the 
keyboard. Most of the functions listed here can also be performed by using 


an equivalent escape code. 


Table 3-4. Control Characters With C3COutl 


Control ASCII Apple IIc 
Character Name Name 
CONTROL-G BEL bell 
CONTROL-H BS backspace 
CONTROL-J LF line feed 
CONTROL-K VT clear EOS 
CONTROL-L FF home 

and clear 
CONTROL-M CR return 
CONTROL-N SO normal 
CONTROL-O SI inverse 
CONTROL-Q DCl 40-column 
CONTROL-R DC2 80-column 
CONTROL-S DC3 stop-list 
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Action Taken by C3COut1 


Produces a 1000-Hz tone for 
0.1 second 


Moves cursor position one space to 
the left; from left edge of window, 
moves to right end of line above 


Moves cursor position down to next 
line in window; scrolls if needed 


Clears from cursor position to the end 
of the screen* 


Moves cursor position to upper-left 
corner of window and clears window* 


Moves cursor position to left end of 
next line in window; scrolls if needed 


Sets display format normal* 
Sets display format inverse* 
Sets display to 40-column* 
Sets display to 80-column* 


Stops listing characters on the display 
until another key is pressedt 
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Table 3-4—continued. Control Characters With C8COut1 


Control 
Character 


CONTROL-U 
CONTROL-V 


CONTROL-W 


CONTROL-X 


CONTROL-Y 


CONTROL-Z 


CONTROL-| 


CONTROL- \ 


CONTROL-] 


CONTROL-_ 


ASCII 
Name 


NAK 
SYN 


ETB 


CAN 


EM 


SUB 


ESC 


FS 


GS 


US 


Apple IIc 
Name 


quit, 


scroll 


scroll-up 


disable 
MouseText 
home 
clear line 
enable 


MouseText 


fwd. space 


clear EOL 


up 


* Doesn't work from the keyboard. 
+ Only works from the keyboard. 


3.3.4 The Stop-List Feature 


Action Taken by C3COut1 
Turns off enhanced video firmware* 


Scrolls the display down one line, 
leaving the cursor in the current 
position* 


Scrolls the display up one line, 
leaving the cursor in the current 
position* 

Disables MouseText charaacter 
display; uses inverse uppercase 


Moves cursor position to upper-left 
corner of window (but doesn’t clear)* 


Clears the line the cursor position is 
on* 

Maps inverse uppercase characters to 
MouseText characters 


Moves cursor position one space to 
the right; from right edge of window, 
moves it to left end of line below* 


Clears from the current cuarsor 
position to the end of the line (that is, 
to the right edge of the window)* 


Moves cursor up a line, no scroll 


You can stop the Apple IIc from updating its display (if it is using either 
COut1 or C3COut1) by pressing [CONTROL HS}. Whenever COut1 or 
C3COut! gets a carriage return from the program, it checks the keyboard for 


a(CONTROL}{S]. Ifa has been pressed, COutl or C8COut1 
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Important! 
AWarning 


stops and waits for another key to be pressed before resuming. The 
character code of the key that is pressed is ignored unless it is 

(CONTROL }{C], which is passed to the program. This feature lets you exit 
BASIC programs from stop-list mode. 


3.3.5 The Text Window 


SS en es 

The active portion of the display is called the text window. After you start 
up the computer or perform a reset, the entire display is the text window. 
COut1 or C3COut1 puts characters only into the window; when it reaches 
the end of the last line in the window, it scrolls only the contents of the 
window. 


You can restrict video activity to any rectangular portion of the display by 
changing the current text window. Your programs can thus control the 
placement of text in the display and protect other portions of the screen 
from being written over by new text. To do this, store the appropriate 
values into four locations in memory to set the top, bottom, left margin, and 
width of the text window. The following memory locations control the text 
window: 


oO The left margin is stored in memory location $20. This number is 
normally 0, the number of the leftmost column in the display. In a 
40-column display, the maximum value for this number is 39 
(hexadecimal $27); in an 80-column display, the maximum value is 79 
(hexadecimal $4F). 

Oo The width of the text window is stored in memory location $21. For a 
40-column display, this value is normally 40 (hexadecimal $28); for an 
80-column display, it is normally 80 (hexadecimal $50). 

oO The position of the top line of the text window is stored in memory 
location $22. This is normally 0, the topmost line in the display. Its 
maximum value is 23 (hexadecimal $17). 

oO The position of the bottom line of the screen plus 1 is stored in memory 
location $23. It is normally 24 (hexadecimal $18) for the bottom line of 
the display. Its minimum value is 1. 


| Pascal does not use this method of supporting window widths. 


Be careful not to let the sum of the window width and the leftmost 
position in the window exceed the width of the display you are using 
(40 or 80 columns). If this happens, COut] or C8COut1 may put 
characters into memory locations outside the display page, possibly 
destroying programs or data. 
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Table 3-5 summarizes the memory locations and the possible values for the 
text window parameters. 


Table 3-5. Text Window Memory Locations 


Window Minimum Normal Values Maximum Walues 
Parameter Location Value 40-col. 80-col. 40-col. 80-col. 
Dec Hex Dec Hex Dec Hex Dec Hex Dec Hex Dec Hex 
Left Edge 32 $20 00 $00 00 $00 00 $00 39 $27 79 $4F 
Width 33 $21 00 $00 40 $28 80 $50 40) $28 80 $50 
Top Edge 34 $22 00 $00 00 $00 00 $00 23 $17 23 $17 


Bottom Edge 30 $23 01 $01 24 = $18 24 $18 24 = $18 24 $18 


3.3.6 Normal, Inverse, and Flashing Text 
SSS ae eT ED 


The way that the Apple IIc displays characters is affected by two things: 
the value that is stored in the inverse flag (zero page location $32), and 
whether the enhanced video firmware is off or on. The inverse flag’s 
influence is discussed in the next two subsections. 


If the enhanced video firmware is off, the Apple IIc displays wh at is called 
Both these display character sets are the primary character set; if the video firmware is on, the Apple IIc displays 
described in Chapter 5. what is called the alternate character set. 


The primary character set includes normal (light on dark), inverse (dark on 
light), and flashing (alternating normal and inverse) characters. Lowercase 
inverse characters are not included in the primary character set. 


The alternate character set includes normal and inverse characters 
(including lowercase inverse), and a set of graphic characters called 
MouseText. Flashing characters are not included in the alternate character 
set. 


If you want your program to display a character, it should first load the 
character to be displayed in the accumulator, and then call the 
character-output subroutine COut. For example, to display the character 
corresponding to $C8, you can use something like this: 


LDA #$C8 
JSR COut 
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For a brief explanation of logical functions, 
refer to Appendix H. 


important! 


MouseText is described more fully in 
Chapter 5. 


See Section 5.2.2. 


Primary Character Set Display 


The primary character set is displayed by COut1, which operates only when 
the enhanced video firmware is off. The primary character set includes text 
in normal, inverse, or flashing format, but not inverse or flashing lowercase 
text. 


If the value of the character sent to COut] is greater than or equal to $A0, 
that value is logically ANDed with the value of the inverse flag (at 
location $32), then displayed. (If you’re curious about which ASCII 
character is being sent, subtract $80 from the value being sent to COut1.) 
You can use the following inverse flag values: 


co $FF (decimal 255) produces the normal character format. 
Oo $8F (decimal 63) produces the inverse character format. 
a $7F (decimal 127) produces the flashing character format. 


To avoid unusual character display results, use only the three values 
$3F $7F, and $FF. 


COutl interprets character values from $80 through $9F as control 
characters and tries to execute them. 


Character values from $00 through $7F are all interpreted as display 
characters, not control characters. 


Alternate Character Set Display 


The alternate character set includes normal and inverse format characters 
and the MouseText graphic characters. You should use C3COut1, the 
standard output link when the enhanced video firmware is active, to 
display the alternate character set. Here are the rules for using the alternate 
character set: 


Oo Control characters are not displayed. Characters sent to C8COut] are 
interpreted as control characters if they are in the range $00 through $1F 
or $80 through $9F. 

o Characters in the range $20 through $7F and $A0 through $FF are 
displayed. 

o If inverse flag (location $32) bit 7 is 1, the character is normal. 

o If inverse flag bit 7 is 0, the character is inverse. 


o If MouseText is off, characters $40 through $5F are remapped to the 
range $00 through $1F and are displayed as uppercase inverse 
characters. 


o If MouseText is on, character values $40 through $5F are left unchanged, 
and the characters are displayed as MouseText. 
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3.4 Port I/O 


important! 


The Apple IIc is a member of the Apple II family of computers; however, 
unlike the Apple II, II Plus, and IIe, the Apple IIc does not have peripheral 
connector slots. In place of these, it has ports—the equivalent of firmware 
interface cards installed in slots. 


3.4.1 Standard Link Entry Points 


To maintain compatibility with existing software and its protocols, each 
port’s I/O firmware has the same standard entry points ($Cn00) as its 
equivalent slot in another Apple II would have. Table 3-6 shows these 
equivalents, as well as listing the chapter where each port is described. 


Section 3.1 describes how and when these entry addresses are placed in 
CSW and KSW. For example, issuing PR#n or IN#n changes the output and 
input links, respectively, so that subsequent output or input is handled by 
the firmware starting at address $Cn00, and thus goes to or comes from the 
selected device. 


Table 3-6. Port Characteristics 


Entry Port 

Port Point Connector Use Ch_apter 

1 $C100 —_ Serial port 1 Printers 7 

2 $C200 — Serial port 2 Communication 8 

3 $0300 Video connectors Enhanced video 5 
firmware 

4 $0400 Mouse Mouse ) 

5 $C500 —_—sIntelligent disk port 

devices 

6 $0600 — Disk drives Built-in and 6 
external drives 

7 $C700 Nodevice Reserved 6 


The addresses shown in Table 3-6 are not entry points in the sense that 
you can send characters to be printed by sending them to JSR 6Cn00. 
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3.4.2 Firmware Protocol 
pa | 


The Apple IIc supports a standard firmware protocol that, in addition to the 


standard link address, provides a table of device identification and entry 
points to standard and optional firmware subroutines. The protocol is 
equivalent to the Pascal 1.1 firmware protocol in use on other Apple II's, 


and is outlined in Table 3-7. 


Table 3-7. Firmware Protocol Locations 


Address Value 
$Cn05 $38 
$Cn07 $18 
$Cn0B $01 
$Cn0C $ci 
$Cn0D ii 
$Cn0E Ir 
$Cn0F ww 


3.4 Port 1/0 


Description 

Pascal firmware card/port identifier 

Pascal firmware card/port identifier 

Generic signature byte of a firmware card/port 


Device signature byte: i is an identifier (not 
necessarily unique). 


c = device class (not all used on the Apple IIc): 


$00 reserved 

$01 printer 

$02 hand control or other X-Y device 
$03 serial or parallel I/O card/port 
$04 modem 

$05 sound or speech device 

$06 clock 

$07 mass-storage device 

$08  80-column card/port 

$09 network or bus interface 

$0A — special purpose (none of the above) 
$0B-OF reserved 


$Cnii is the initialization entry address (PInit). 


$Cnrr is the read routine entry address (PRead) 
(returns character read in A register). 


$Cnww is the write routine entry address 
(PWrite) (enters with character to write in 
A register). 
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For more information, refer to the hardware 
page memory map in Appendix B. 
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Table 3-7—continued. Firmware Protocol Locations 


Address Value Description 


$Cn10 SS $Cnss is the status routine entry address 
(PStatus) (enters with request code in A register: 
( to ask “Are you ready to accept output?” or 1 to 
ask “Do you have input ready?” ). 


$Cnll $00 if additional address bytes follow; nonzero if not 


Each table begins with identification bytes ($Cn05 through $Cn0C). Then, 
starting with address $Cn0D, each byte in the table represents the low-order 
byte of the entry-point address of a firmware routine. The high-order byte of 
each address is always $Cn, where n is the port number. Your program uses 
these byte values to construct its own jump table for subroutine calls to the 
ports. 


All port routines require, on entry, that the X register contain $Cn and that 
the Y register contain $n0. 


All routines, on exit, return an error code in the X register (0 means no error 
occurred; 3 means the request was invalid). The carry bit in the program 
status register usually contains a reply to a request code (0 means no; 

] means yes). 


All the Apple IIc ports except the disk port conform to this protocol. The 
disk port is described in Chapter 6. 


3.4.3 Port |/O Space 


[Ss re ee eee) 

By aconvention used in other Apple II series machines, each port or slot has 
exclusive use of 16 memory locations set aside for data input and. output. 
The addresses of these locations are of the form $C080 + #n0, where n is 
the port or slot number. Table 8-8 lists the port I/O space used in the 

Apple Ile. 


Table 3-8. Port I/O Locations 


Port Locations 

l $C090-$CO9F 

2 $COA0-$COAF 
6 $COEO-$COEF 
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3.4.4 Port ROM Space 


Seed 

In the Apple II and Ile, one 256-byte page of memory space is allocated to 
each slot. This space is used for read-only memory (ROM or PROM on the 
interface card) with driver programs that control the operation of 
input/output devices, as outlined in Table 38-7. On the Apple IIc, this space 
is dedicated to port firmware. However, I/O ROM space in the Apple IIc is 
used as efficiently as possible, and there is not a strict correspondence 
between firmware for port n and the $Cn00 space, except as regards entry 
points. 


3.4.5 Expansion ROM Space 


The 2K-byte memory space from $C800 to $CFFF in the Apple IIc—called 
expansion ROM space on the Apple II, {I Plus, and Ile—contains the 
enhanced video firmware and port and memory transfer subroutines. The 
Apple IIc, unlike the II, II Plus, or Il e, always has this space switched in. 


3.4.6 Port Screen Hole RAM Space 


aire ee ee ee eee el) 

There are 128 bytes of memory (64 in main memory, 64 in auxiliary 
memory) allocated to the ports, 8 bytes per port, as shown in Table 3-9. 
These bytes are reserved for use by the system, except as described in 
Chapters 4 through 9. 


Table 3-9. Port Screen Hole Memory Locations 


Base Ports: 
Address 1 2 3 4 5 6 7 


$0478 $0479 $047A $047B $0470 $047D S047E $047F 
$04F8 304F9 $04FA = $04FB S04FC =O S04FD = S04FE — $04 FFF 
$0578 $0579 = $057A = $057B) = 8057C)~=3— ss $057D Ss S057E~=—s $05 7F 
$05F8 $05F9 $05FA $05FB $05FC S05FD S05FE S05FF 
$0678 $0679 $067A $067B $0670 $067D $067E $067F 
$06F8 S06F9 = S06FA = SO6FB Ss SO6FC) =O SO6FD = SO6FE =—_: S06F F 
30778 $0779 =$077A $077B $0770 ~=—s $077D-— ss S$O77E~—s $077F 
$07F8 $O7F9 $O7FA SO7FB $07FC $07FD $07FE = S07FF 
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These addresses are unused bytes in the RAM reserved for text and 
low-resolution graphics displays, and hence they are sometimes called 
screen holes. These particular locations are not displayed on the screen and 
their contents are not changed by the built-in output routines. In other 
words, they are used by the output routines but they are not part of the 
video display. 


AWarning All the screen holes in auxiliary memory, and many of them in main 
memory, are reserved for special use by Apple IIc firmware—for 
example, to store initialization information. Do not use any locations 
marked reserved in this manual. 


The way that port firmware uses these RAM locations and their addresses is 
covered in Chapters 4 through 10. 


3.5 Interrupts 
aa 
Appendix E describes interrupt handling on Interrupts are a way to more efficiently use the hardware in a computer. 
the Apple llc. Interrupt support built into the Apple IIc’s firmware is described briefly 

below. 


When the IRQ line on the 65C02 microprocessor is activated, the 65C02 
transfers program control through the vector in locations $FFFE through 
$FFFF of ROM or whichever bank of RAM is switched in (Chapter 2). If 
ROM is switched in, this vector is the address of the Monitor’s interrupt 
handler, which determines whether the request is due to an interrupt that 
should be handled internally. If so, the Monitor handles it and then returns 
control to the interrupted program. 


If the interrupt is due to a BRK ($00) instruction, control is transferred 
through the BRK vector ($03F0-03F 1). Otherwise, control is tramsferred 
through the IRQ vector ($03FE-$03FF). 
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Chapter 4 


Keyboard and Speaker 


7] 


This chapter describes how to use two of the Apple IIc’s built-in devices: the 
keyboard and the speaker. 


4.1 Keyboard Input 


SSS ee ee a ge aie 


For a description of how the keyboard 
strobe works, refer to Appendix E. 
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Important! 


Table 4-1 describes the characteristics of the keyboard that relate to 
programming. You won't have to write routines to read the keybo ard from 
all your assembly-language programs since the Apple IIc firmware Monitor 
provides keyboard support through the three standard input routines 
described in Chapter 3—RdKey, KeyIn, and GetLn. You can do all your 
keyboard handling directly in your programs if you want to, but it’s nice to 
know that you're not forced to. 


4.1.1 Reading the Keyboard 


SEE = SS 

The keyboard encoder and ROM (see Chapter 11) can generate all 

128 ASCII codes, so all the special character codes in the ASCII character 
set are available from the keyboard. Your machine-language programs can 
call RdKey to get characters from the keyboard. RdKey reads characters a 
byte at a time from the keyboard data location ($C000) shown in Table 4-1. 


Here is how your programs should go about reading the keyboard: 


1. Test bit 7 of address $C000 to see if a key has been pressed. Bit 7 is the 
keyboard strobe bit. 

2. When bit 7 goes to a 1, you know that the low-order seven bits of $C000 
are a valid character. 

3. Clear the keyboard strobe (bit 7) at $C000 by reading or writing 
anything to address $C010. 


$C010 has another function besides clearing the keyboard strobe: its high 
bit is a 1 while a Key is pressed (except the Apple keys, [CONTROL], (SHIFT }, 
(CAPS LOCK], and (RESET }). Bit 7 at this location is therefore called 
any-key-down. You could use this to let a program do something useful 
other than just waiting for the next key to be pressed. (People are generally 
a lot slower than the Apple IIc.) Check $C010 occasionally to see if 
something should be done. 


If your program needs to read both the keyboard flag and strobe, it must 
read the strobe bit first. Anytime you read the any-key-down bit at $C010, 
you also clear the keyboard strobe bit at $C000. 
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Game input switches: See Chapter 9. 


GetLn, GetLn1, and RdiKey: See Chapter 3. 


Table 4-1. Keyboard Input Characteristics 


Port number: None 

Commands: Keyboard is always on, in the sense that any keypress 
generates a KSTRB. 

Initial 


characteristics: Reset routine clears the keyboard strobe and sets the 
keyboard as the standard input device (that is, sets KSW to 


point to RdKey). 
Hardware locations: 
$000 Keyboard data and strobe 
$C010 Any-key-down flag and clear-strobe switch 
$C060 40-column switch status on bit 7; 
1 = 40-column display = switch down 
$C061 (G] status on bit 7; 1 = pressed (also game input switch 0) 
$0062 (#) status on bit 7; 1 = pressed 


Monitor firmware routines: 


Location Name Description 

$FD6A GetLn Gets an input line with prompt 

$FD67 GetLnZ Gets an input line with preceding carriage 
return 

$FD6F GetLn1 Gets an input line, but with no preceding 
prompt 

$FDIB Keyln The keyboard input subroutine 

$FD35 RdChar Gets an input character or escape code 

$FDOC RdKey The standard character input subroutine 

Use of other pages: 

Page 2 The standard character string input buffer (see GetLn 

description) 
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After your program has cleared the keyboard strobe, the strobe remains low 
until another key is pressed. 


Table 4-2 shows the ASCII codes generated by all the keys on th.e Apple Ilc 
keyboard. Remember, if the strobe bit is set, the character values that your 
program sees will be equal to the values given in Table 4-2 plus $80. 


Table 4-2. Keys and ASCII Codes 
Note: Codes are in hexadecimal here; refer to Table G-8 for decimal eq-uivalents. 


Key Key Alone + CONTROL + SHIFT + Both 
Code Char Code Char Code Char Code Char 
(F DEL TF DEL (F DEL (F DEL 
[=] 08 BS 08 BS 08 BS 08 BS 
09 HT 09 HT 09 HT 09 HT 
CG) 0A LF OA LF OA LF OA LF 
[+] OB VT OB VT OB VT OB VT 
OD CR OD CR OD CR OD CR 
[=] 15 NAK 15 NAK 15 NAK 15 NAK 
1B ESC 1B ESC IB ESC 1B ESC 
20) SP 20 SP 20 SP 20 SP 


a an {an 2 m2” 
< 2 0, ac < & =z 
= 2D IF US SF _ IF US 
> ¥ oF 3. > $B > 
/? oF / oF / SF? SF? 
0) 30 «(0 30 0 99) 9) 
1! 31 31 a! 1 
2@ 8 2 00 NUL 40 #@ 00 NUL 
3# 33 3 33 8 23 o# 93 # 
4$ 34 =O 34.4 4 4 § 
5% 35 5 9B 5 % 5 % 
6° 36 OG IE RS SE * IE — RS 
7& 37°C 7 OT 6 & 6 & 
g* 388 38:8 oA 7) 
9( 39g 39g 28 | 2 
3B 3B 3A 3A 
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Table 4-2—continued. Keys and ASCII Codes 


Note: Codes are in hexadecimal here; refer to Table G-8 for decimal equivalents. 


Key Key Alone + CONTROL + SHIFT + Both 
Code Char Code Char Code Char Code Char 
=+ 3D = 3D = 2B + 2B + 
[{ 5B [ 1B ESC 7B { 1B ESC 
\ | 5C : 1C FS 7C | 1C FS 
]} 5D 1D GS 7D \ 1D GS 
_ 60 ; 60 ; 7E 7 7E : 
A 61 a 01 SOH 4] A 01 SOH 
B 62 b 02 STX 42 B 02 STX 
C 63 C 03 ETX 48 C 03 ETX 
D 64 d 04 EOT 44 D 04 KOT 
K 65 e 05 ENQ 45 E 05 ENQ 
F 66 f 06 ACK 46 F 06 ACK 
G 67 g 07 BEL 47 G 07 BEL 
H 68 h 08 BS 48 H 08 BS 
| 69 i 09 HT 49 I 09 HT 
J 6A j OA LF 4A J OA LF 
K 6B k 0B VT 4B K OB VT 
L 6C l OC FF AC L OC FF 
M 6D m OD CR 4D M OD CR 
N 6E n OF SO 4k N OE SO 
O 6F 0 OF SI 4k O OF SI 
P 70 Dp 10 DLE 50 P 10 DLE 
Q 71 q 11 DCl ay Q ll DCl 
R 12 r 12 DC2 2 R 2 DC2 
S 73 S 13 DC3 53 S 13 DC3 
T 74 t 14 DC4 54 T 14 DC4 
U 15 u 15 NAK 55 U 15 NAK 
V 716 V 16 SYN 56 V 16 SYN 
W (ut W 17 ETB 7 W yi ETB 
X 18 X 18 CAN 58 X 18 CAN 
¥ 79 y 19 EM 59 Y 19 EM 
Z TA Vs 1A SUB 5A Z 1A SUB 


4.1 Keyboard Input 


Keystrokes can also generate interrupts: 
See Appendix E. 


This restarting process is called the reset 
routine, and is described in Chapter 2. 


For information on how to have programs 
interpret keystrokes in a standard way, 
refer to the Apple II Design Guidelines 
listed in the Bibliography. 
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There are several keys that do not generate ASCII codes themselves, but 
alter the characters produced by other keys. These modifier keys are 
[CONTROL }, (SHIFT), and [CAPS LOCK]. 


Your programs can also use the [G] and (#] as character modifier keys while 
handling keyboard input, and, if one or both of them is pressed, branch to a 
special routine, such as a help program. Your program can read (G] at $C061 
and (#é] at $C062. 


Another key that doesn’t generate a code is (RESET ], located at the 
upper-left corner of the keyboard; it is connected directly to the Apple IIc’s 


processor. Pressing with depressed normally causes the 
system to stop whatever program it’s running and restart itself. If you hold 


while pressing [CONTROL } RESET ], the Apple IIc performs a forced cold 
start. The restart sequence is described in Chapter 2. 


4.1.2 Monitor Firmware Support for Keyboard Input 


Chapter 3 describes the three standard Monitor input routines serving the 
keyboard: GetLn, RdKey, and Keyln. This section discusses the three other 
available Monitor routines. 


GetLnZ 


GetLnZ (at address $FD67) is an alternate entry point for GetLn that first 
sends a carriage return to the standard output, then continues into GetLn. 


GetLn1 


GetLn1 (at address $FD6F) is an alternate entry point for GetLn that does 
not issue a prompt before it accepts the input line. However, if the user 
cancels the input line with too many backspaces or with [CONTROL |x], 
then GetLn1 issues the prompt stored at location $33 when it gets another 
line. 


RdChar 


RdChar (at address $FD85) is a subroutine that gets characters from the 
standard input subroutine, and also interprets the escape codes Listed in 
Chapter 3. 


If the enhanced video firmware is active, [=] ((CONTROL }{U ]) reads a 
character from the screen as if it were typed from the keyboard. This is a 
function of the Monitor’s built-in editing capability described in Chapter 3. 
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4.2 Speaker Output 


OTT TTT EE NEE EE ee a ee ea eae 


Electrical specificatioms of the speaker 
circuit appear in Chapster 11. 


Important! 


The Apple IIc has a small speaker mounted near the front of the bottom 
plate of its case. The speaker is connected to a soft switch that toggles; that 
is, the switch has two states, off and on, and it changes from one to the 
other each time it is accessed. Table 4-8 describes the speaker output 
characteristics. 


Table 4-3. Speaker Output Characteristics 


Port number: None 

Commands: Some programs sound the speaker in response to 
CONTROL-G. 

Initial 


characteristics: Reset routine sounds the speaker. 


Hardware location: 


$C030 Toggle speaker (read only) 


Monitor firmware routines: 


Location Name Description 
$FBDD Bell 1 Sends a beep to the speaker 
SFF3A Bell Sends CONTROL-G to the current output 


4.2.1 Using the Speaker 
Sa eee Sere 


If you switch the speaker once, by reading or writing to $C080, it emits a 
click; to make longer sounds, access the speaker repeatedly. The switch for 
the speaker uses memory location $C030. You can make various tones and 
buzzes with the speaker by using combinations of timing loops in your 
program. 


You should always use a read operation to toggle the speaker. If you write 
to this soft switch, it switches twice in rapid succession. The resulting 
pulse is so short that the speaker doesn’t have time to respond; it doesn’t 
make a sound. 
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See Chapter 3. 
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4.2.2 Monitor Firmware Support for Speaker Output 
ea i ag em ee Nn ee ee ee een) 


The Monitor supports the speaker with one simple routine, Bell1. A related 
routine, Bell, supports the current output device—the one that CSW points 
to. 


Bell1 


Belll (at address $FDBB) makes a beep through the speaker by generating a 
1-kHz tone in the Apple IIc’s speaker for 0.1 second. This routine scrambles 
the A and X registers. 


Bell 


The Monitor routine Bell (at location $FF3A) writes a bell control character 
(ASCII CONTROL-G) to the current output device. This routine leaves the 
accumulator holding $87. 
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Chapter 5 Video Display Output 


19 


The Apple IIc’s primary output device is its video display. You can use any 
ordinary color or monochrome video monitor with the Apple IIc. An 
NTSC stands for National Television ordinary monitor is one that accepts NTSC-compatible composite video. If 
Standards Committee, a group that you use Apple IIc color graphics with a black-and-white monitor, the display 


ne ae esau will appear as black, white, and two shades of gray. 


other countries. If you are only using graphics modes and 40-column text, you cam use a 
television set for your video display. If the TV set has an input connector for 
composite video, you can connect it directly to your Apple IIc; otherwise, 
you must attach an RF video modulator between the Apple IIc and the 
television set. 


important! The Apple IIc can produce an 80-column text display. However, if you use 
an ordinary color or black-and-white television set, 80-column text will be 
too blurry to read. For a clear 80-column display, you must use a 
high-resolution video monitor with a bandwidth of 14 MHz or greater. 


Table 5-1 summarizes the video output port’s characteristics and. points to 
other information in this chapter. 


Table 5-1. Video Output Port Characteristics 


Port number: Output port 3 
Commands: See Figure 5-3 
Initial characteristics: See Figure 5-3 


Note: If a program is to use the 
enhanced video firmware, it should 
turn it on and then immediately check 
the 80/40 switch. If the switch is in 
the 40 position, the program should 


issue a CONTROL-Q. 
Hardware locations: See Table 5-7 
Monitor firmware routines: See Table 5-11 
1/0 firmware entry points: See Table 5-12 
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5.1 Video Display Specifications 


OE SSS See ee ee ee a eee ee ee ae 


Table 5-2 summarizes the video display’s specifications, and provides a 
further guide to other information in this chapter. 


Table 5-2. Video Display Specifications 


Display modes: 40-column text; map: Figure 5-5 
80-column text; map: Figure 5-6 


Low-resolution color graphics; 
map: Figure 5-7 


High-resolution color graphics; 
map: Figure 5-8 


Double-high-resolution color graphics; 
map: Figure 5-9 


Text capacity: 24 lines by 80 columns (character 
positions ) 

Character set: 96 ASCII characters (uppercase and 
lowercase ) 

Display formats: Normal, inverse, flashing, MouseText 
(Table 5-3) 

Low-resolution graphics: 16 colors (Table 5-4): 40 horizontal by 


48 vertical; map: Figure 5-7 


High-resolution graphics: 6 colors (Table 5-5): 140 horizontal by 
192 vertical (restricted) 


Black-and-white: 280 horizontal by 
192 vertical; map: Figure 5-8 


Double-high-resolution graphics: 16 colors (Table 5-6): 140 horizontal by 
192 vertical (no restrictions) 


Black-and-white: 560 horizontal by 
192 vertical; map: Figure 5-9 


The video signal produced by the Apple IIc is NTSC-compatible composite 

color video available at two places on the back panel of the Apple IIc: the 

RCA-type phono jack and the 15-pin D-type connector. Use the RCA-type 
See Section 11.9.5 for moore on video phono jack to connect a video monitor, and the DB-15 connector for an 
expansion hardware. external video modulator or other video expansion hardware. 
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5.2 Text Modes 

a ae ee SERN eA a ee a ey 
Either of the Apple IIc’s two text modes can display all 96 ASCII characters: 
uppercase and lowercase letters, the ten digits, punctuation marks, and 
special characters. Each character is displayed in an area of the screen that 
is seven dots wide by eight dots high. The characters are formed by a dot 
matrix five dots wide (with a few exceptions, such as underscore), leaving 
two blank columns of dots between characters in a row. Except for 
lowercase letters with descenders, the characters are only seven. dots high, 
leaving one blank line of dots between rows of characters. 


The normal display has white (or other monochrome color used by your 
monitor) dots on a dark background. Characters can also be displayed as 
black dots on a white background; this is called inverse format. 


5.2.1 Text Character Sets 


———— SESS) 

The Apple IIc can display either of two text character sets: the primary set 
and an alternate set (Table 5-3). The forms of the characters in the two sets 
are actually the same, but the available display formats are different. The 
display formats are 


O normal, with white dots on a black screen 
O inverse, with black dots on a white screen 
oO flashing, alternating between normal and inverse. 


The Apple IIc can display uppercase characters in all three formats— 
normal, inverse, and flashing—with the primary character set. Lowercase 
letters can only be displayed in normal format. This makes the primary 
character set compatible with most software written for the Apple II and 
II Plus, which can display text in flashing format but don’t have Lowercase 
characters. 


The alternate character set trades the flashing format for a comp _lete set of 

inverse characters. With the alternate character set, the Apple IIc can 

display uppercase letters, lowercase letters, numbers, and specia] 

characters in either normal format or inverse format. It can also Glisplay 
MouseText: See Section 5.2.2. MouseText. 


You can select between character sets with the alternate-text soft switch, 
described in Section 5.6. Table 5-3 shows the character codes in dlecimal 
and hexadecimal for the Apple IIc primary and alternate character sets in 
normal, inverse, and flashing formats. 
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To identify particular characters and 
values, refer to Table 4-2. 


Table 5-3. The Display Character Sets 


Hex Primary Character Set Alternate Character Set 

Values Character Type Format Character Type Format 
$00-$1F Uppercase letters Inverse Uppercase letters Inverse 
$20-$38F Special characters Inverse Special characters Inverse 


$40-$5F Uppercase letters Flashing MouseText 


$60-$7F Special characters Flashing Lowercase letters Inverse 
$80-$9F Uppercase letters Normal Uppercase letters Normal 
$A0-$BF Special characters Normal Special characters Normal 
$C0-$DF Uppercase letters Normal Uppercase letters Normal 
$EO-$FF Lowercase letters Normal Lowercase letters Normal 


Each character on the screen is stored as one byte of display data. The 
low-order six bits make up the ASCII code of the character being displayed. 
The remaining two (high-order) bits select format and the group within 
ASCII (Section 3.3.6). 


5.2.2 Mousetftext 


LSE =e es 

The alternate character set contains 32 graphics characters called 
MouseText in place of the primary set’s inverse uppercase characters from 
$40 through $5F. These graphics are especially convenient to use with a 
mouse, since they can be generated by character codes instead of groups of 
high-resolution byte values, and they can be moved around quickly. To use 
MouseText characters, do the following: 


1. Turn on the enhanced video firmware with PR#3 or 6 CONTROL-P. 

2. Set inverse mode: use the INVERSE command or put $8F in 
location $32, or print CONTROL-O. 

3. Turn on MouseText with PRINT CHR$(27); or pass $1B to COut in the 
accumulator. 

4. Print the uppercase letter (or other ASCII character in the range $40 
through $5F: @[ \] *or — ) that corresponds to the MouseText 
character you want. 


5. Turn off MouseText with PRINT CHR$(24); or pass $18 to COut] in the 
accumulator. 
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6. Set normal mode: use the NORMAL command or put $FF im 
location $32, or print a CONTROL-N. 


Here is a sample Applesoft program that prints all the MouseText 
characters: 


18 D$=CHR$C(4) 

28 PRINT PRINT D$;"PR#3" 

36 INVERSE 

40 PRINT CHR$C27);"@ABCDEFGHI JKLMNOPQRSTUVWXWZL1*_"; 
S8 PRINT CHR$C24); 

68 NORMAL 


MouseText characters and their corresponding ASCII characters are shown 
in Figure 5-1. 


Figure 5-1. MouseText Characters 


on z 


A 


a 


5.2.3 40-Column Versus 80-Column Text 


The Apple IIc has two text display modes: 40-column and 80-col umn. The 
number of dots in each character does not change, but the charaacters in 
80-column mode are only half as wide as the characters in 40-column mode. 
Compare the two displays in Figure 5-2. On an ordinary color or 
black-and-white television set, the narrow characters in the 80-column 
display blur together; you must use the 40-column mode to display text on a 
television set. 
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Figure 5-2. 40-Column and 80-Column Text (With Alternate Character Set) 


100 “PRINT. ORMAL then NVE 
| RSE, then FLASH: PRINT 
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Figure 5-3 shows the characteristics of the text display modes and how to 
switch between them. 


Figure 5-3. Text Mode Characteristics and Switching 


Power On (ESC) (CONTROL)-{) 


Resets full 
40-column window 


Cursor: checkerboard 
Input hook: Keyin 
Output hook: COut1 
Window: 40 columns, 
24 lines 
Character Set: primary 


40 Columns, 
“Apple II” Video 
Firmware 


40 Columns, 80 Columns, 
Enhanced Video (Do not affect 1/O hooks) Enhanced Video 
Firmware 


Firmware 
(ESC) 4 


Cursor: square box Cursor: nar row box 
Input hook: C3Keyin Input hook: C3Keyin 
Output hook: C3COut1 Output hook: C3COut1 
Window: 40 columns, Window: 80 columns, 
24 lines 24 lines 
Character Set: alternate Character Set: alternate 
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5.3 Graphics Modes 

a 
The Apple IIc can produce color video graphics in any of three different 
modes: 


O low-resolution graphics, 48 rows by 40 columns 
O high-resolution graphics, 192 rows by 280 columns 
O double-high-resolution graphics, 192 rows by 560 columns 


Each graphics mode treats the screen as a rectangular array of spots. 
Normally, your programs will use the features of some high-level language 
to draw graphics dots, lines, and shapes on the screen; this section describes 
the way the resulting graphics data are stored in the Apple IIc’s memory. 


5.3.1 Low-Resolution Graphics 
————————————————— re ee 


The Apple IIc displays an array of 48 rows by 40 columns of colored blocks 
in the low-resolution graphics mode. Each block can be any one of sixteen 
colors, including black and white. On a black-and-white monitor or 
television set, these colors appear as black, white, and two shades of gray. 
There are no blank dots between blocks; adjacent blocks of the same color 
merge to make a larger shape. 


The low-resolution graphics display data are stored in the same part of 
memory as the data for the 40-column text display. Each byte contains data 
for two low-resolution graphics blocks. The two blocks are displayed one 
atop the other in a display space the same size as a 40-column text 
character, seven dots wide by eight dots high. 


Half a byte—four bits, or one nibble—is assigned to each graphics block. 
Each nibble can have a value from 0 to 15, and this value determines which 
one of sixteen colors appears on the screen. The colors and their 
corresponding nibble values are shown in Table 5-4. In each byte, the 
low-order nibble sets the color for the top block of the pair, and the 
high-order nibble sets the color for the bottom block. Thus, a byte 
containing the hexadecimal value $D8 produces a brown block atop a 
yellow block on the screen. 


5.3 Graphics Modes 87 


88 


Table 5-4. Low-Resolution Graphics Colors 


Note: Colors may vary, depending on adjustment of monitor or television set. 


Nibble Value Nibble Value 
Decimal Hex Color Decimal Hex Color 
0 $00 black 8 $08 brown 
1 $01 magenta 9 $09 orange 
2 $02 dark blue 10 $0A gray 2 
3 $03 purple 11 $0B pink 
4 $04 dark green 12 $0C light green 
5 $05 = gray 1 13 $0D yellow 
6 $06 medium blue 14 $0E aquamarine 
7 $07 light blue 15 $OF white 


As explained in Section 5.5, the text display and the low-resolution graphics 
display use the same area in memory. Your programs should usually clear 
this part of memory when they change display modes, but you can store 
data as text and display them as graphics, or vice versa. All you have to do 
is change the mode switch, described in Section 5.6, without changing the 
display data. This usually produces meaningless jumbles on the display, but 
some programs have used this technique to good advantage for producing 
complex low-resolution graphics displays quickly. 


5.3.2 High-Resolution Graphics 


Ee 0 a pe ae 

In the high-resolution graphics mode, the Apple IIc displays an array of 
colored dots in 192 rows and 280 columns. The colors available are black, 
white, purple, green, orange, and blue, although the colors of the individual 
dots are limited, as described below, by the color of adjacent dots. Adjacent 
dots of the same color merge to form a continuous colored area. 


High-resolution graphics display data are stored in either of two 8192-byte 
areas in memory. These areas are called high-resolution Page 1 amd Page 2; 
think of them as display data buffers. Normally, your programs vvill use the 
features of some high-level language to draw graphics dots, lines, and 
shapes to display; this section describes the way the resulting graphics data 
are stored in the Apple IIc’s memory. 
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The Apple IIc high-resolution graphics display is bit-mapped: each dot on 
the screen corresponds to a bit in the Apple IIc’s memory. The seven 
low-order bits of each display byte control a row of seven adjacent dots on 
the screen, and 40 adjacent bytes in memory control a row of 280 

(7 times 40) dots. The eighth bit (the most significant) of each byte is not 
displayed; it selects one of two color sets, as described below. The least 
significant bit of each byte is displayed as the leftmost dot in a row of seven, 
followed by the next-least significant bit, and so on, as shown in Figure 5-4. 


Figure 5-4. High-Resolution Display Bits 


Bits in Data Byte 


Dots on Graphics Screen 


There is a simple correspondence between bits in memory and dots on the 
screen on a black-and-white monitor. A dot is white if the bit controlling it is 
on (1), and the dot is black if the bit is off (0). On a black-and-white 
television set, pairs of dots merge together; alternating black and white dots 
merge to a continuous gray. 


A dot whose controlling bit is off (0) is black on an NTSC color monitor or a 
color television set. If the bit is on, the dot is white or a color, depending on 
its position, the dots on either side, and the setting of the high-order bit of 
the byte. Call the leftmost column of dots column 0, and assume (for the 
moment) that the high-order bits of all the data bytes are off (0). If the bits 
that control them are on, dots in even-numbered columns, 0), 2, 4, and so 
forth, are purple, and dots in odd-numbered columns are green—but only if 
the dots on either side are black. If two adjacent dots are both on, they are 
both white. 
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For more details about the way the 
Apple IIc produces color on a TV set, see 
Chapter 11. For a table of reversed bit 
patterns, refer to Appendix H. 
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You select the other two colors, blue and orange, by turning the high-order 
bit (bit 7) of a data byte on (1). The colored dots controlled by a byte with 
the high-order bit on are either blue or orange: the dots in even-n umbered 
columns are blue, and the dots in odd-numbered columns are orange (again, 
only if the dots on either side are black). Within each horizontal line of 
seven dots controlled by a single byte, you can have black, white, and one 
pair of colors. To change the color of any dot to one of the other pair of 
colors, you must change the high-order bit of its byte, which affects the 
colors of all seven dots controlled by the byte. 


In brief, high-resolution graphics displayed on a color monitor or television 
set are made up of colored dots, according to the following rules: 


O Dots in even-numbered columns can be black, purple, or blue. 
O Dots in odd-numbered columns can be black, green, or orange. 
oO If adjacent dots in a row are both on, they are both white. 


oO The colors in each row of seven dots controlled by a single byte are either 
purple and green, or blue and orange, depending on whether the 
high-order bit is off (0) or on (1). 


These rules are summarized in Table 5-5. The blacks and whites are 
numbered to remind you that the high-order bit is different. 


Table 5-5. High-Resolution Graphics Colors 


Note: Colors may vary, depending on adjustment of monitor or televiszon set. 


Bits 0-6 Bit 7 Off Bit 7 On 
Adjacent columns off black 1 black 2 
Even columns on purple blue 
Odd columns on green orange 
Adjacent columns on white 1 white 2 


The peculiar behavior of the high-resolution colors reflects in part the way 
NTSC color television works. The dots that make up the Apple II¢ video 
signal are spaced to coincide with the frequency of the color subcarrier used 
in the NTSC system. Alternating on and off dots at this spacing c ause a 
color monitor or TV set to produce color, but two or more on dots together do 
not. 
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important! 


5.3.3 Double-High-Resolution Graphics 


The horizontal resolution of double-high-resolution graphics is 560 dots per 
line, with 192 lines. Double-high-resolution graphics maps the low-order 
seven bits of the bytes in the two double-high-resolution graphics pages. A 
double-high-resolution page is made up of a 8192-byte page in main memory 
and an equivalent page having the same address in auxiliary memory. In 
most cases, only the first double-high-resolution graphics page is used. 


The bytes in the main-memory and auxiliary-memory pages are displayed 
in exactly the same manner as the characters in 80-column text: of each 
pair of identical addresses, the auxiliary-memory byte is displayed first, and 
the main-memory byte is displayed second. A dot whose controlling bit is 
off (0) is black when displayed. 


Unlike high-resolution color (Section 5.3.2), double-high-resolution color has 
no restrictions on which colors can be adjacent. Color is determined by any 
four adjacent dots along a line. Think of a four-dot-wide window moving 
across the screen: at any given time, the color displayed corresponds to the 
4-bit value from Table 5-6 that corresponds to the window’s position 
(Figure 5-9). Effective horizontal resolution with color is 140 (560 divided 
by 4). 


Table 5-6, on the next page, describes the data values used to produce colors 
in double-high-resolution graphics. To use the table, divide the column 
number by 4, and use the remainder to find the correct column: abd is a 
byte residing in auxiliary memory corresponding to a remainder of 0 

(byte 0, 4, 8, and so on), mb/ is a byte residing in main memory 
corresponding to a remainder of 1 (byte 1, 2, 9 and so on), and similarly for 
ab2 and mbé. 


5.4 Mixed-Mode Displays 


Any of the graphics displays can have four lines of text, either 40-column or 
80-column, at the bottom of the screen. Graphics displays with text at the 
bottom are called mixed-mode displays. To use them, the TEXT switch 
must be off (read $C050) and the MIXED switch on (read $C053). 


| You cannot display 40-column text with double-high-resolution graphics. 


To determine what appears where in mixed-mode displays, refer to Figures 
0-6 through 5-9 in Section 5.7. See the bottom sixth of the appropriate text 
display (Figure 5-5 or 5-6) and the upper five-sixths (down to the heavy 
horizontal line) in the appropriate graphics display (Figures 5-7 to 5-9). 


5.4 Mixed-Mode Displays 9] 


Table 5-6. Double-High-Resolution Graphics Colors 
Note: Colors may vary, depending on adjustment of monitor or television set. 


Repeated 
Color abO mb1 ab2 mb3 Bit Pattern 
black $00 $00 $00 $00 0000 
magenta $08 $11 $22 $44 0001 
brown $44 $08 $11 $22 0010 
orange $4C $19 $33 $66 0011 
dark green $22 $44 $08 $11 0100 
gray | $2A $55 $2A $55 0101 
green $66 $4C $19 $33 0110 
yellow $6E $5D $3B $77 0111 
dark blue $11 $22 $44 $08 1000 
purple $19 $33 $66 $4C 1001 
gray 2 $55 $2A $55 $2A 1010 
pink $5D $3B $77 $6E 1011 
medium blue $33 $66 $4C $19 1100 
light blue $3B $77 $6E $5D 1101 
aqua $77 $6E $5D $3B 1110 
white $7F $7F $7F $7F wae 


= = Unused bit 


Bits in Data Byte 


ee ie ee 43210 


Display 012 3;0 1 2 3;0 1 2 3/0 1 2 3)0 1 2 3]0 12 310 123 


Dots on Graphics Screen 
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5.5 Display Pages 
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important! 


The Apple IIc uses data stored in specific areas in memory to generate its 
video displays. These areas, called display pages, serve as buffers where 
your programs can put data to be displayed. Kach byte in a display buffer 
controls an object—a character, a colored block, or a group of adjacent 
dots—at a certain location on the display, depending on the current display 
mode. 


The 40-column-text and low-resolution-graphics modes use two display 
pages of 1024 bytes each. These are called text Page 1 and text Page 2, and 
they are located at $0400 through $07FF and $0800 through $OBFF in main 
memory. Normally, only Page 1 is used, but you can put text or graphics 
data into Page 2 and switch between displays. Kither page can be displayed 
as 40-column text, low-resolution graphics, or mixed-mode (four lines of text 
at the bottom of a graphics display). 


The 80-column text mode displays twice as much data as the 40-column 
mode—1920 bytes—but it cannot switch pages when the enhanced video 
firmware is active. The 80-column text display uses a combination page 
made up of text Page 1 in main memory plus another page in auxiliary 
memory. This additional memory is not the same as text Page 2—in fact, it 
is text Page 1X, and it occupies the same address space as text Page 1 (see 
Figure 2-11). The built-in firmware I/O routines described in Chapter 3 take 
care of this extra addressing automatically; that is one reason to use these 
routines for all normal text output. 


The built-in video firmware always displays Page 1 text. You cannot 
write text to Page 2 with the built-in firmware. 


The high-resolution graphics mode also has two display pages, but each 
page is 8192 bytes long. In the 40-column text and low-resolution graphics 
modes each byte controls a display area seven dots wide by eight dots high. 
In high-resolution graphics mode each byte controls an area seven dots wide 
by one dot high. Thus, a high-resolution display requires eight times as 
much data storage as a low-resolution display, as shown in Table 5-7. 


The double-high-resolution graphics mode interleaves the two 
high-resolution pages (Pages 1 and 1X) in exactly the same way as 
80-column text mode interleaves the text pages: column 0 and all 
subsequent even-numbered columns come from the auxiliary page; 
column 1 and all subsequent odd-numbered columns come from the main 


page. 
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Table 5-7. Video Display Page Locations 


Display 
Display Mode Page Lowest Address Highesé Address 
40-column text, 1 $0400 1024 $O7FF 2047 
low-resolution a $0800 2048 SOBFF 3071 
graphics 
80-column text 1 $0400 1024 $O7FF 2047 
2* $0800 2048 SOBFF 3071 
High-resolution 1 $2000 8192 $3FFF 16383 
graphics 2 $4000 16384 $5FFF 24575 
Double-high- lt $2000 8192 $3FFF 16888 
resolution at $4000 16384 $5FFF 24575 
graphics 


* This is not supported by firmware; for instructions on how to switch pages, refer to 
Section 5.6. 
+ See Section 5.3.3. 


5.6 Display Mode Switching 
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Table 5-8 shows the reserved locations for the soft switches that control the 
different display modes. The column of the table labeled Actzon indicates 
what to do to activate or read a switch setting: R means read the location, W 
means write anything to the location, R/W means read or write, and R7 
means read the location and then check bit 7. 


Table 5-9 lists the display modes that the firmware can set up 
automatically. In the 40-column modes, the contents of the standlard I/O 
hooks KSW and CSW (Chapter 3) determine whether the enhanced video 
firmware features are available or not. The firmware also takes care of 
setting or clearing AltChar. 


Table 5-10 lists other display modes available but not supported by 
firmware. For modes that display Page 2 with the 80Col switch om, your 
program may have to turn 80Store off after the firmware has turned it on. 


Double-low-resolution shows on the display screen when HiRes is off and 
both 80Col and DHiRes are on. It is the low-resolution graphics equivalent of 
80-column text, and it uses the same map (Figure 5-6), giving you 48 rows of 
80 blocks. 
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The IOUDis ($CO7E) switch must be on to allow you to use locations $CO5E 
and $C05F to change DHiRes. The firmware in fact leaves it on—and your 

program should, too—unless it wants to use locations $CO5E and $CO5F to 

change mouse values (Chapter 9). 


Table 5-8. Display Soft Switches 


Name Action Hex Function 

AltChar W $COOE Off: Display text using primary character set 
AltChar W $COOF On: Display text using alternate character set 
RdAltChar R7 $COl1E Read AltChar switch (1 = on) 

80Col W $C00C Off: Display 40 columns 

80Col W $C0OD On: Display 80 columns 

Rd80Col R7 $COIF Read 80Col switch (1 = on) 

80Store W $C000 Off: Cause Page? on to select auxiliary RAM 
80Store W $C001 On: Allow Page2 to switch main RAM areas 
Rd80Store R7 $C018 Read 80Store switch (1 = on) 

Page2 R/W $C054 Off: Select Page 1 

Page2 R/W $C055 On: Select Page 1X (80Store on) or 2 

RdPage2 R7 $C01C Read Page2 switch (1 = on) 

TEXT R/W $C050 Off: Display graphics or (if MIXED on) mixed 
TEXT R/W $C051 On: Display text 

RdTEXT R7 $CO1A Read TEXT switch (1 = on) 


MIXED R/W $C053 Off: Display only text or only graphics 
MIXED R/W $C054 On: (If TEXT off) display text and graphics 
RdMIXED ~~ R77 $C01B Read MIXED switch (1 = on) 
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Table 5-S—continued. Display Soft Switches 


Name Action Hex 

HiRes R/W $C057 
HiRes R/W $0058 
RdHiRes R7 $C01D 
IOUDis W $CO7E 
IOUDis W SCO7F 
RdIOUDis ‘R77 $CO7E 


DHiRes R/W SC05E 
DHiRes R/W $CO5F 


RdDHiRes R77 $COTF 


Function 


Off: (if TEXT off) display low-resolution 
graphics 


On: (If TEXT off) display high-resolution or (if 
DHiRes on) double-high-resolution graphics 


Read HiRes switch (1 = on) 


On: Disable IOU access for addresses $C058 to 
$CO5F; enable access to DHiRes switch* 


Off: Enable IOU access for addresses $C058 to 
$CO5F; disable access to DHiRes switch* 


Read IOUDis switch (1 = off)t 


On: (If IOUDis on) turn on 
double-high-resolution 


Off: (If IOUDis on) turn off 
double-high-resolution 


Read DHiRes switch (1 = on)t 


* The firmware normally leaves IOUDis on. See also the following footnote. 
+ Reading or writing any address in the range $C070-$CO7F also triggers the paddle timer 


and resets VBLInt (Chapter 9). 


Table 5-9. Display Modes Supported by Firmware (Including Applesoft) 


Display Switches: 

Col/Res Type Page 80Col 80Store Page2 
40-column text ] off off 
80-column text Nt on : 

low-res graphics 1 off off 
40 /low mixed l off off 
80/low mixed ] on : off 
hi-res graphics 1 off off 
hi-res graphics 2 off on 
40/high mixed l off off 
80/high mixed l on . off 


* 80Store is set by the firmware when 80Col is turned on. 
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TEXT MIXED HiRes DHiRes 


on off off off 
on 

off off off off 
off on off 

off on off off 
off off on 

off off on 

off on on 

off on on off 


Table 5-10. Other Display Modes 


Display Switches: 

Col/Res Type Page 80Col 80Store Page2 TEXT MIXED HiRes DHiRes 
40-column text 2 off on on 

80-column 2 on off on on 

low-res graphics 2 off on off off off 

40/low rnixed 2 off on off on off 

80/low rmixed 2 on off on off on off off 
dbl-low graphics 1 on : off off off off on 
dbl-low graphics 2 on off on off off off on 
80/dbl-low rnixed l on 7 off off on off on 
80/dbl-low rnixed 2 on off on off on off on 
40/high rmixed a off on off on on 

80/high rnixed 2 on off on off on on off 
dbl-high graphics 1 on * off off off on on 
dbl-high graphics 2 on off on off off on on 
80/dbl-high rnixed l on . off off on on on 
80/dbl-high rmixed 2 on off on off on on on 


* 80Store is set by the firmware when 80Col is turned on, and must be turned off to use the second 80-column or double-high-resolution 
page. This means that you cannot use firmware routines such as COut when displaying Page 2 modes not supported by firmware. 


For example, to switch to mixed 80-column and double-high-resolution 
display Page 1, you can use these instructions in your program: 


STA $CBOD 
LDA $C 654 
STA $C O56 
STA $C 853 
STA $C657 
STA S$CB7E 
LDA $COSE 


Turns on 80Col; firmware then turns on 80Store. 
Turns off Page2; you could also have done a STA. 
Turns off TEXT; that is, turns on graphics mode. 
Turns on MIXED; it works now that TEXT is off. 
Turns on HiRes; it works now that TEXT is off. 
Makes sure IOUDis is on so you can access DHiRes. 
Turns on DHiRes; it works now that IOUDis is on. 


5.7 Display Page Maps 

eee ee SS a sr rey 
You should never have to store directly into display memory. Most 
high-level languages let you write statements that control the text and 
graphics displays. Similarly, if you are programming in assembly language, 
you should use the display features of the built-in I/O firmware. 


AWarning Never call any firmware with 80Col on or with 80Store and Page2 both 
on. If you do, the firmware will not function properly. As a general rule, 


always leave Page? off. 
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For more details about the way the displays 
are generated, see Chapter 11. 
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All the different display modes use the same basic addressing scheme: 
characters or graphics bytes are stored as rows of 40 contiguous bytes, but 
the rows themselves are not stored at locations corresponding to their 
locations on the display. Instead, the display address is transforrmed so that 
three rows that are eight rows apart on the display are grouped together and 
stored in the first 120 locations of each block of 128 bytes ($80 hex). For 
example, the first 128-byte block contains the data for rows 0, 8, and 16. 
The next 128-byte block contains data for rows 1, 9, and 17, and so on. 


The display memory maps are shown in Figures 5-5 through 5-9. For a full 
description of the way the Apple IIc hardware handles display memory, see 
Section 11.9.2. 


High-resolution graphics data are stored in much the same way as text, but 
there are eight times as many bytes to store, because eight rows of dots 
occupy the same space on the display as one row of characters. 


The first 1024 bytes of the high-resolution display page contain the first row 
of dots from each of the 24 groups of eight rows of dots. The second 1024 
bytes of the high-resolution display page contain the second row of dots 
from each group of eight rows of dots, and so on for all eight row's of all the 
groups. This fills up the 8192 bytes of the high-resolution display page. 


The display maps show addresses only for each Page 1. To obtain addresses 
for text or low-resolution graphics Page 2, add 1024 ($0400); to obtain 
addresses for high-resolution Page 2, add 8192 ($2000). 


The 80-column display works a little differently. Half of the data are stored 
in the normal text Page 1 memory, and the other half are stored -in the 
auxiliary memory text Page 1. The display circuitry fetches bytes from 
the same address in both memory areas simultaneously and displays them 
sequentially: first the byte from the auxiliary memory, then the byte from 
the main memory. The characters in the even-numbered columns of the 
display are stored (starting with column Q) in main memory, and the 
characters in the odd-numbered columns of the display are stored (starting 
with column 1) in main memory. 


To store display data in auxiliary memory, first turn on the 80Stere soft 
switch by writing to location $C001. With 80Store on, the page-select switch 
Page2 selects between the portion of the 80-column display stored in Page 1 
of main memory and the portion stored in the auxiliary memory. To select 
auxiliary memory, turn the Page2 soft switch on by reading or writing at 
location $C055. 
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The double-high-resolution graphics display stores information in the same 
way as high-resolution graphics, except there is an auxiliary memory 
location as well as a main memory location corresponding to each address. 
The two sets of display information are interleaved in a manner similar to 
the interleaving of two 40-column displays to create an 80-column text 
display (Figure 5-9). 


Figure 5-5. Map of 40-Column Text Display 
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Figure 5-6. Map of 80-Column Text Display 
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Figure 5-7. Map of Low-Resolution Graphics Display 
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Figure 5-8. 
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Map of High-Resolution Graphics Display 
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Figure 5-9. Map of Double-High-Resolution Graphics Display 
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5.8 Monitor Support for Video Display Output 
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Table 5-11 summarizes the addresses and functions of the video display 

support routines the Monitor provides. Except for COut and COut1, which 
are explained in Chapter 3, these routines are described in the subsections 
that follow. 


Table 5-11. Monitor Firmware Routines 


Name 
ClrEOL 
CIEOLZ 


ClrEOP 
ClrScr 

ClrTop 
COut 


COutl 
CROut 
CROut1 


HLine 
HOME 


PLOT 
PrBl2 


PrByte 
PrErr 


PrHex 
PrntAX 


Location 


SFC9C 
SFC9E 


$FC42 
F832 
$F 836 
$FDED 


SFDF0 
$FD8E 
$FD8B 


$F819 
SFC58 


$F800 
SF94A 


SFDDA 
$FF2D 


$FDE3 
$F941 


Description 
Clears to end of line from current cursor position 


Clears to end of line using contents of Y register as 
cursor position 


Clears to bottom of window 
Clears the low-resolution screen 
Clears top 40 lines of low-resolution screen 


Calls output routine whose address is stored. in CSW 
(normally COut1, Chapter 3) 


Displays a character on the screen (Chapter 3) 
Generates a carriage return character 


Clears to end of line, then generates a carria ge return 
character 


Draws a horizontal line of blocks 


Clears the window and puts cursor in upper-left corner 
of window 


Plots a single low-resolution block on the screen 


Sends 1 to 256 blank spaces to the output device whose 
address is in CSW 


Prints a hexadecimal byte 


Sends ERR and CONTROL-G to the output device 
whose output routine address is in CSW 


Prints four bits as a hexadecimal number 


Prints contents of A and X in hexadecimal 
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Table 5-11—continued. Monitor Firmware Routines 


Name Location Description 

SCRN $F871 Reads color value of a low-resolution block on the 
screen 

SetCol  $F864 Sets the color for plotting in low-resolution 

VTabZ $FC24 Sets cursor vertical position (setting CV at location $25 
does not change vertical position until a carriage 
return) 

VLine $F828 Draws a vertical line of low-resolution blocks 

CIrEOL 


ClrEOL clears a text line from the cursor position to the right edge of the 
window. This routine destroys the contents of A and Y. 


CIEOLZ 


CIEOLZ clears a text line to the right edge of the window, starting at the 
location given by base address BASL indexed by the contents of the 
Y register. This routine destroys the contents of A and Y. 


CirEOP 


ClrEOP clears the text window from the cursor position to the bottom of the 
window. This routine destroys the contents of A and Y. 


CirScr 


ClrScr clears the low-resolution graphics display to black. If you call this 
routine while the video display is in text mode, it fills the screen with 
inverse-mode at-sign (@) characters. This routine destroys the contents 
of A and Y. 


CirTop 


ClrTop is the same as ClrScr, except that it clears only the top 40 rows of 
the low-resolution display. 
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COut 


COut calls the current character output subroutine (Section 3.3.1). The 
character to be sent to the output device should be in the accumulator. COut 
calls the subroutine whose address is stored in CSW (locations $36 
and $37), usually the standard character output COutl. 


Cout1 


COut1 (Section 3.3.2) displays the character in the accumulator on the 
display screen at the current cursor position and advances the cursor. It 
places the character using the setting of the inverse mask (location $32). It 
handles these control characters: carriage return, line feed, backspace, and 
bell. When it returns control to the calling program, all registers are intact. 


CROut 


CROut sends a carriage return to the current output device. 


CROut1 


CROut] clears the screen from the current cursor position to the edge of the 
text window, then calls CROut. 


HLine 


HLine draws a horizontal line of blocks of the color set by SetCol on the 
low-resolution graphics display. Call HLine with the vertical coordinate of 
the line in the accumulator, the leftmost horizontal coordinate in the 

Y register, and the rightmost horizontal coordinate in location $2C. HLine 
returns with A and Y scrambled and X intact. 


HOME 


HOME clears the display and puts the cursor in the upper-left corner of the 
screen. 


PLOT 


PLOT puts a single block of the color value set by SetCol on the 
low-resolution display screen. Call PLOT with the vertical coordinate of the 
line in the accumulator, and its horizontal position in the Y register. PLOT 
returns with the accumulator scrambled, but X and Y intact. 
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PrBi2 


PrBl2 sends from 1 to 256 blanks to the standard output device. Upon entry, 
the X register should contain the number of blanks to send. If X = $00, then 
PrBlank will send 256 blanks. 


PrByte 


PrByte sends the contents of the accumulator in hexadecimal to the current 
output device. The contents of the accumulator are scrambled. 


PrErr 


PrErr sends the word ERR, followed by a bell character (ASCII $07), to the 
standard output device. On return, the accumulator is scrambled. 


PrHex 


PrHex prints the lower nibble of the byte in the accumulator as a single 
hexadecimal digit. On return, the contents of the accumulator are 
scrambled. 


PrntAX 


PrmntAX prints the contents of the A and X registers as a four-digit 
hexadecimal value. The accumulator contains the first byte printed, and 
the X register contains the second. On return, the contents of the 
accumulator are scrambled. 


SCRN 


SCRN returns the color value of a single block on the low-resolution display. 
Call it with the vertical position of the block in the accumulator and the 
horizontal position in the Y register. The block’s color is returned in the 
accumulator. No other registers are changed. 


SetCol 


SetCol sets the color used for plotting in low-resolution graphics to the value 
passed in the accumulator. The colors and their values are listed in 
Table 5-4. 
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VLine 


VLine draws a vertical line of blocks of the color set by SetCol on the 
low-resolution display. Call VLine with the horizontal coordinate of the line 
in the Y register, the top vertical coordinate in the accumulator, and the 
bottom vertical coordinate in location $2D. VLine returns with the 
accumulator scrambled. 


5.9 |/O Firmware Support for Video Display Output 

a a a eee a en, 
Apple IIc video firmware conforms to the I/O firmware protocol described 
in Section 3.4.2. However, it does not support windows other than the full 
80-by-24 window in 80-column mode, and the full 40-by-24 window in 
40-column mode. 


The video (port 3) protocol table is shown in Table 5-12. 


Table 5-12. Port 3 Firmware Protocol Table 


Address’ Value Description 

$C30B ~—s $001 Generic signature byte of firmware cards 

$C30C —- $88 80-column card device signature 

$C30D _iSii $C3ii is entry point of initialization routine (Plnit). 
$C30E — $rr $C3rr is entry point of read routine (PRead). 

$C30F  $ww $C3ww is entry point of write routine (PWrite). 
$0310 $ss $C8ss is entry point of the status routine (PS tatus). 
Pinit 


PInit does the following: 


sets a full 80-column window 

sets 80Store ($C001) 

sets 80Col ($C00D) 

switches on AltChar ($CO00F) 

clears the screen; places cursor in upper-left corner 
displays the cursor 


OO adaoda O 
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PRead 


PRead reads a character from the keyboard and places it in the accumulator 
with the high bit cleared. It also puts a 0 in the X register to indicate 
IOResult = GOOD. 


PWrite 


PWrite should be called after placing a character in the accumulator with 
its high bit cleared. PWrite does the following: 


o turns the cursor off 


o if the character in the accumulator is not a control character, turns the 
high bit on for normal display or off for inverse display, displays it at the 
current cursor position, and advances the cursor; if at the end of a line, 
does carriage return but not line feed 


O carries out control functions as shown in Table 5-13 


Table 5-13. Pascal Video Control Functions 


CONTROL- Hex Function 

Kore $05 Turns cursor on (enables cursor display) 

F or f $06 Turns cursor off (disables cursor display) 

Gorg $07 Sounds bell (beeps) 

Horh $08 Moves cursor left one column; if cursor was at 
beginning of line, moves it to end of previous line 

Jor j $0A Moves cursor down one row; scrolls if needed 

K or k $0B Clears to end of screen 

Lor] $0C Clears screen; moves cursor to upper-left of screen 

Morm $0D Moves cursor to column 0) 

Norn $0E Displays subsequent characters in normal video; 
characters already on display are unaffected 

Ooro SOF Displays subsequent characters in inverse video; 
characters already on display are unaffected 

Vorv $16 Scrolls screen up one line; clears bottom line 

W orw $17 Scrolls screen down one line; clears top line 

Yory $19 Moves cursor to upper-left (home) position on screen 
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Table 5-13—continued. Pascal Video Control Functions 


CONTROL- Hex Function 

Z or Z $1A Clears entire line that cursor is on 

lor \ $1C Moves cursor right one column; if at end of line, does 
CONTROL-M 

bor] $1D Clears to end of the line the cursor is on, including 


current cursor position; does not move cursor 


or 6 $1E GOTOxy: Initiates a GOTOxy sequence; interprets the 
next two characters as x+32 and y+82, resp ectively 


_ $1F If not at top of screen, moves cursor up one line 


When PWrite has completed this, it 


o turns the cursor back on (if it was not intentionally turned off) 


oO puts a0 in the X register (IOResult = GOOD) and returns to the calling 
program. 


PStatus 


A program that calls PStatus must first put a request code in the 
accumulator: either a 0 (meaning “Ready for output?”) or a 1 (meaning “Is 
there any input?”). PStatus returns with the reply in the carry bit: 0 (no) or 
1 (yes). If the request was not 0 or 1, PStatus returns with a 3 in the 

X register JOResult = ILLEGAL OPERATION); otherwise, PStatus returns 
with a 0 in the X register (IOResult = GOOD). 
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Chapter 6 Disk Input and Output 
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UniDisk 3.5 


The Apple IIc supports both its built-in disk drive and an optiona | external 
5'4-inch drive; both drives use single-sided, 143K-capacity, 35-tra.ck, 
16-sector format. Table 6-1 summarizes disk I/O port characteris tics. 


A new version of the Apple IIc supports UniDisk 8.5, a 32-inch, 
double-sided, 800K-capacity disk drive. The UniDisk 38.5 is an 2 ntelligent 
device: the Apple IIc does not have to do all the work of controlling it 
when reading or writing information on the disk. Programs ma ke requests 
through the operating system to the intelligent device, the device works 
on the request, and, when finished, responds to the operating system. 


The Protocol Converter in the firmware of the new version of t_he 

Apple IIc, described in this chapter, provides a way of communicating 
with UniDisk 3.5. The Protocol Converter communicates through the 
Apple IIc’s disk I/O port and allows intelligent devices to be daisy 
chained, which means that the first device is plugged into the disk port, 
the next device is plugged into the first device, and so on. 


The Protocol Converter can handle up to 127 devices in a daisy chain, but 
the Apple IIc sets a much lower limit, since it can provide power to only a 
few devices at one time. The Disk IIc is still supported, as long as it is the 


last device in the daisy chain. 


Table 6-1. Disk I/O Port Characteristics 


Port number: 


Commands: 


Initial characteristics: 


Hardware location: 
$COEO-EF 

Monitor firmware routines: 
1/0 firmware entry points: 


Use of screen holes: 
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I/0 port 6 drive 1 (built-in drive) 
I/0 port 6 drive 2 (external drive) 
IN#6 or PR#6 

CALL -151 (to get to the Monitor 


from BASIC), then 6 CONTROL-K or 
6 CONTROL-P 


All resets except 
with a valid reset vector eventually 
pass control to the built-in disk drive. 


Reserved 
None 
$C600 (port 6) 


Port 6 main and auxiliary memory 
screen holes are reserved. 


The external disk drive connector is 
described in Section 11.10. 


UniDisk 3.5 


The disk I/O firmware resides in the $C600 address space. It supports the 
built-in drive as if it were slot 6 drive 1, and the external drive as if it were 
slot 6 drive 2. If disk startup is unsuccessful, the firmware shuts off the disk 
drive motor and displays the message Check Disk Drive onthe display 
screen. 


For Apple IIc’s that support UniDisk 3.5, disk startup is tried with both 
the built-in drive and the first device connected to the disk I/O port. If 
both tries fail, the message Check Disk Drive appears on the display 
screen. 


6.1 Startup 


The Apple IIc has two ways to start up—a cold start and a warm start. A 
cold start clears the machine’s memory and tries to load an operating 
system from disk. A warm start stops the current program that is running 
and leaves the machine in Applesoft with memory and programs intact. 


A cold start can be initiated by any of the following: 


oO turning the machine on 


O pressing CONTROL 
O issuing a reboot command from the Monitor, BASIC, or a program 


O pressing [CONTROL }{ RESET |, if a valid reset vector does not exist 


The cold-start routine first sets a number of soft switches (see Chapter 2) 
and then passes control to the program entry point at $C600. This code 
turns on the internal drive motor, recalibrates the read/write head at track 
(), then reads sector 0 from that track. The sector contents are loaded into 
memory starting at address $0800; then program control passes to $0801. 
The program loaded depends on the operating system or application 
program on the disk. 


To restart the system from BASIC, issue a PR#6 command; from Monitor 
command mode, issue 6 CONTROL-P; and use JMP $C600 from a 
machine-language program. 


A warm start begins when you press [CONTROL }{ RESET ], if a valid reset 
vector exists. Normally, a warm start leaves you in BASIC with memory 
unchanged. If a program has changed the reset vector the system won’t do a 
warm start; instead, it may do any number of things. Usually it either does a 
cold start or it beeps or does nothing, leaving you in the currently executing 
program. 


6.1 Startup et: 


6.2 External Drive Startup 


Original lic 


UniDisk 3.5 


UniDisk 3.5 


A block device reads or writes information 
in organized groups called blocks, which 
are typically 512 bytes in size. A disk drive 
is a block device. Compare this with a 
character device, which reads or writes 
data sequentially. Printers, modems, and 
plotters are character devices. 
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You might need to start your Apple IIc from an external drive if, for 
example, the built-in drive fails. The way this works depends on the type of 
Apple IIc you have and the software you want to run. 


The ProDOS operating system (but not the DOS or Pascal operating 
systems) supports startup using the external Disk IIc drive. Thais ProDOS 
feature makes it possible to start the Apple IIc with a diagnostic program 
in the event that the built-in drive does not work. 


To restart from the Monitor using the external Disk IIc, insert a ProDOS 
disk in the external drive, then start the Monitor by typing CALL -151 
and pressing (7 } (CONTROL }{P }. 


To restart from BASIC using the external Disk IIc, insert a ProDOS disk in 
the external drive, then type PR#7. 


External drive startup using PR#7 works on the original Apple IIc only 
with ProDOS-based programs. It does not work with Pascal 1.0 or later 
versions, or with DOS 3.3. 


The Apple IIc that supports UniDisk 3.5 can use PR#5 to start up from an 
external Disk IIc or from the first intelligent drive connected to the 
Protocol Converter through the disk port. Starting up from an e xternal 
intelligent drive works from ProDOS or Pascal 1.3, but not from. DOS or 
versions of Pascal earlier than 1.3. 


6.3 The Protocol Converter 
kk 


The rest of this chapter applies only to the version of the Apple IIc that 
supports UniDisk 3.5. 


The rest of this chapter is about the Protocol Converter, which is a set of 
assembly-language routines used to support external I/O devices, such as 
UniDisk 3.5. To ProDOS and Pascal 1.3, the Protocol Converter ap-pears to be 
a block device. 


The following topics are discussed: 


O Od a O QO 


how to locate the Protocol Converter 

how to issue a call to the Protocol Converter 
how to use each call 

the parameters required for each call 
possible errors codes returned for each call 
the possible causes of the errors 
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At the end of this chapter is an example of an assembly-language program 
that uses a Protocol Converter call. 


6.3.1 Locating the Protocol Converter 


DO I EE 


The Protocol Converter code in the Apple IIc’s firmware always begins at 
address $C500. To ensure compatibility of your programs with the Apple Ile, 
however, your Protocol Converter routines should always begin with a 
search for the Protocol Converter. Your program can identify the Protocol 
Converter by finding the following bytes: 


$Cn01 = $20 
$Cn03 = $00 
$Cn05 = $03 
$Cn07 = $00 


where n can be an integer from 1 to 7. The Protocol Converter entry point is 
then found at address $Cn00 + ($CnFF) + 3, where ($CnFF) refers to the 
value of the byte located at $CnFF. The sample program at the end of this 
chapter illustrates such a search. 


6.3.2 Issuing a Call to the Protocol Converter 


OL  —EE ee SS SSS SSS SS SS SSS Se eee 


MLI calls: See the PraDOS Technical 
Reference Manual, Chapter 4. 


Protocol Converter calls are coded like ProDOS Machine Language Interface 
(MLI) calls: the program executes a JSR to a dispatch routine at address 
$C500 + ($C5FF) + 3, where ($C5FF) refers to the value of the byte located 
at $C5FF. 


The Protocol Converter call number and a two-byte pointer to the call’s 
parameter list must immediately follow the call. Here is an example of a call 
to the Protocol Converter: 


IWMCALL JSR DISPATCH Calls PC command dispatcher 
DFB CmdNum Specifies the command type 
DW CmdList 2-byte (low, high) pointer to parameter 
list 
BCS ERROR Sets carry on an error 
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Reading and writing to RAM: See Section 
2.4. 
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The command number (CmdNum) defines which Protocol Converter call 
you want to make. Most Protocol Converter calls include a two-bryte pointer 
to a parameter list. The parameter list can contain information to be used by 
the call, or can provide space for information to be returned by the call. The 
length and content of the parameter list depend on the call being made. The 
format of each Protocol Converter call’s parameter list is described in 
Section 6.4. 


When the call has finished, the program resumes execution at the 
statement following the pointer to the parameter list. In the example above, 
the DFB and DW statements are skipped, and execution resumes with the 
BCS statement. If the call is successful, the C flag (in the processor status 
register) is cleared (0), and the accumulator (the A register) is cleared to all 
Qs. If the call is unsuccessful, the C flag is set (1), and the error cede is 
placed in the A register. After the Protocol Converter call, the contents of 
the 65C02’s registers are as follows: 


Register: Processor Status X Y A PC S 
Bit: NZCODVI B 

Successfulcall: x x 0 0 x uu x x <0 JSR+3 u 
Unsuccessful 

call: x x 10Oxuu68 x x Error JSR+3 u 


X = undefined, except in cases where index information is returned in X and W 
u = unchanged 


6.3.3 Cautions 
ae er) 


You must observe the following cautions when using the Protocol 
Converter, or your program will crash: 


oO Leave space on the stack for the Protocol Converter. The Protacol 
Converter requires up to 35 bytes of stack space. Be sure you t.ake this 
into account when calculating the stack space used by your program. If 
you don’t do this, you program will fail if it tries to access data that wsed 
to be on the stack. 


O Besure that all RAM that you intend the Protocol Converter to access is 
both read-enabled and write-enabled. The Protocol Converter must be 
able to read from the RAM after writing to it, to obtain a checksum. 
Failure to observe this rule results in an error (BusErr $06). 


Don’t pass data to or from the Protocol Converter through any zero page 
locations. Some of these locations are reserved for temporary storage of 
data by the Protocol Converter, and your data will get changed. 


O 
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6.4 Descriptions of the Protocol Converter Calls 


5 aE A Fa CN POPS Oy gE DN he STI ea Eg ee Oh ee] 
Calls to the Protocol Converter are used 


to obtain status information about a device 
to reset a device 

to format the medium in a device 

to read from a device 

to write to a device 

to send control information to a device. 


Oodaddad Oo QO 


The Protocol Converter calls, in command-number sequence, are: 


STATUS ($00) Returns status information about a particular 
device, including general status (character or 
block device, read or write protection, format 
allowed, device on line); the device control 
block (set with the CONTROL call); the 
device newline status (character devices 
only); and device-specific information 
(number of blocks, ID string, device name, 
device type, device firmware version). 


READ BLOCK ($01) Reads one 512-byte block from a disk device, 
and writes it to memory. 


WRITE BLOCK ($02) Writes one 512-byte block from memory to a 


disk device. 

FORMAT ($03) Prepares all blocks on a block device for 
reading and writing. 

CONTROL ($04) Controls some device functions, including 


soft resets, setting the device control block 
(which controls global aspects of the device's 
operating environment), setting newline 
status (character devices only), and device 
interrupts. Several CONTROL calls are 
device-specific. 


INIT ($05) Resets all resident devices. A global reset is 
done automatically on startup or system 
resets from the keyboard; an application 
should never have to reset all devices. 


OPEN ($06) Prepares a character device for reading or 
writing. 
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CLOSE ($07) Tells a character device that a sequence of 


reads or writes is over. 

READ ($08) Reads a specified number of bytes from a 
specified device. 

WRITE ($09) Writes a specified number of bytes from 


memory to a specified device. 


The following sections describe each Protocol Converter call, including the 
command number, the parameter list, and error codes. The calls are 
discussed in command-number order in this format: 


Command Name: The name used to identify the call. 


Command Number: A hexadecimal number that specifies which call is 
being made to the Protocol Converter. 


Parameter List: A list of required call parameters. 
General Description: What the call does and what you use it for. 


Parameter Descriptions: A description of each parameter and the data it 
refers to. When a parameter refers to a status or control code, the meaning 
of each code number is discussed. 


Possible Errors: A list of the error codes that can be returned by this call. 
A complete list of Protocol Converter error codes is included at the end of 
this chapter. 
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Important! 


6.4.1 STATUS 


| 
Command Number $00 


Parameter List $03 (parameter count) 
Unit number 
Status list pointer (low byte, high byte) 
Status code 


The STATUS call returns status information about a specified device. The 
type of information returned is determined by the device and its status-code 
parameter. The status list pointer defines where the status information is 
returned to. 


STATUS returns the number of bytes of status information that it generates 
in the X and Y registers, the low byte of this number in the X register, and 
the high byte in the Y register. 


Parameter Descriptions 


Parameter 

Count 

1-byte value 3 for this call. 

Unit Number The Protocol Converter assigns each device a unique 
1-byte value number during initialization (on startup and cold 


reset). The numbers are in the range $01-$7E, and are 
assigned according to the devices’ positions in the 


chain. 
You can get the status of the Protocol Converter itself if you use a unit 
number of $00 and a status code of $00 in a STATUS call (see the 
discussion beginning “Status code = $00,” below). 
Status List Points to the buffer to which the status is to be 
Pointer returned. The length required for the buffer varies 
2-byte value depending on the status request being made. 
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Status Code 
1-byte value 


Indicates what kind of status request is being made. 
Status codes are in the range $00-$FF, as follows: 


Code Status Returned 


$00 Return device status 

$01 Return device control block (DCB) (not supported 
by UniDisk 3.5) 

$02 Return newline status (character devices only) 
(not supported by UniDisk 3.5) 

$03 Return device information block (DIB) 


$05 Return UniDisk 3.5 status 


Status code = $00 returns a device status consisting of four bytes. The first 
is the general status byte, with the following format: 


Bit 


Ore POO SP CIO. A 


Description 


Q = character device, 1 = block device 

1 = write allowed 

1 = read allowed 

1 = device on line or disk in drive 

() = format allowed 

Q = medium write protected (block devices onl y) 

1 = device currently interrupting 

1 = device currently open (character devices o nly) 


If the STATUS call is for a block device, the next three bytes (low byte 
first) are the size in 512-byte blocks. The maximum size is 16 million 
($FFFFFF) blocks (about 8 gigabytes). If the call is for a character device, 
these three bytes must be set to 0. 


A STATUS call with status code = $00 and unit number = $00 returns the 
status of the Protocol Converter itself. In this case, the status list consists of 
eight bytes, as follows: 


STAT_LIST DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 


Number_Devices Devices hooked to PC 
Interrupt_Status — Bit 6 clear = interrupt sent 

Reserved 

Reserved 

Reserved 

Reserved 

Reserved 

Reserved 
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Newline read mode: S ee Chapter 4 in the 
ProDOS Technical Reference Manual. 


The Number__Devices byte returns the total number of intelligent devices 
attached to the Protocol Converter. The Interrupt_Status byte is a copy of 
the asynchronous communications interface adapter (ACIA) status register 
at the time of the interrupt, and is used to indicate that a device requires 
interrupt servicing. If the sixth bit of this byte equals 0, one or more devices 
in the Protocol Converter bus daisy chain must be serviced; your interrupt 
handler must poll each device on the chain to determine which ones. 


About Interrupts: Devices that require interrupt servicing must use the 
EXTINT line on the Apple IIc’s external disk port connector to be 
supported by the Protocol Converter. 


For example, UniDisk 3.5 does not support this line, and so cannot 
generate interrupts to the Protocol Converter. See Section 6.4.5 for 
instructions on enabling Protocol Converter interrupts. See Appendix E 
for more information about programming with interrupts. 


Status code = $01 returns the device control block (DCB). The DCB is used 
to control various operating characteristics of a device, and is device 
dependent. Each device has a default DCB, which can be altered with a 
CONTROL call. The first byte (the count byte) gives the number of bytes in 
the control block (not including the count byte), so the length never 
exceeds 256 bytes (257 including the count byte). Note that UniDisk 3.5 has 
no DCB, and returns an error (BadCtl $21) in response to this call. 


Status code = $02 returns newline status. Newline status applies only to 
character devices. A status code = $02 passed to a block device returns a 
BadCtl ($21) error. 


Status code = $08 returns the device information block (DIB). The device's 
information block identifies the device, its type, and various other 
attributes. The returned status list has the following form: 


STAT_LIST DFB Device_Statbyte1 Sameas byte | in status 


code = 0 

DFB Device_Size_Lo Number of blocks (block 
device) 

DFB Device_Size_Med Number of blocks (middle 
byte) 

DFB Device_Size_Hi Number of blocks (high 
byte) 

DFB ID_String-Length Length in bytes (16 max.) 

ASC ‘<device name>’ 7-bit ASCII, uppercase, 


padded with spaces, 8th 
bit always=0 (16 bytes) 

DFB Device_Type-Code 

DFB Device_Subtype_Code 

DW =Version Device firmware version 
number 
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Status code = $05 returns the UniDisk 3.5 status. This call allows a 
diagnostic program to get more detailed information about the cause of a 
read or write error, and to examine the contents of the 65C02’s registers 
after a CONTROL call with control code = $05 (see Section 6.4.5). The 
returned status list has this form: 


STAT_LIST DFB $068 


DFB Error Soft Error byte (see below) 

DFB Retries Numberof retries (see below) 

DFB $80 

DFB A_Value Acc value aftera CONTROL EXECUTE 
call 


DFB X_Value  X value after EXECUTE 
DFB Y_Value _ Y value after EXECUTE 
DFB P_Value _ Processor status value after EXECUTE 


The Error byte returned by aSTATUS call with status code = $05 contains 
the following bits: 


Bit Description 


0 

0 

1 = address field mark or checksum error 

1 = data field checksum error 

1 = data field bitslip mark mismatch 

1 = seek error; unexpected track value found 
in address field 


Ro GC SP O'S ~~ 


eo — 
SS 


The Retries byte returned by a STATUS call with status code = $05 
specfies the number of address fields that had to be passed before the 
operation was completed. This information could be used, for ex ample, to 
determine the number of passes necessary to read a data field correctly: If 
Retries is found to be greater than the number of sectors on the target track, 
then more than one pass was required. 


The last four bytes of the status list are set only after a CONTROL call with 
control code = $05, and are 0 after any other call (STATUS calls do not 
clear the status bytes). 
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Possible Errors 
The following errors can be returned by the STATUS call: 


$01 BadCmd An unimplemented command was issued 
$04 BadPCnt Bad call parameter count 

$06 BusErr Communications error 

$21 BadCtl Invalid status code 

$30-$3F Device-specific errors 


6.4.2 READ BLOCK 


Command Number $01 


Parameter List $03 (parameter count) 

Unit number 

Data buffer (low byte, high byte) 

Block number (low byte, mid byte, high byte) 
The READ BLOCK call reads one 512-byte block into memory from the 
block device specified by the unit-number parameter. The block of data is 


placed in a buffer starting at the address specified by the data-buffer 
parameter. 


Parameter Descriptions 


Parameter 

Count 

1-byte value 3 for this call. 

Unit Number The Protocol Converter assigns each device a unique 
1-byte value number during initialization (on startup and cold 


reset). The numbers are in the range $01-$7E, and are 
assigned according to the devices’ positions in the 
daisy chain. A unit number of $00 in the STATUS call 
returns the number of devices connected to the 
Protocol Converter. 
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Data Buffer Points to the buffer into which the data are read. The 
2-byte value buffer must be 512 or more bytes in length. 


Block Number The logical address of a block of data to be read. There 

3-byte value is no general connection between block nurnbers and 
the layout of tracks and sectors on the disk. The 
translation from logical to physical blocks is 
performed by the device. (The most significant byte is 
Q for all devices currently in use.) 


Possible Errors 


The following errors can be returned by the READ BLOCK call: 


$01 BadCmd 
$04 BadPCnt 
$06 BusErr 
$27 IOError 
$28 NoDrive 
$2D BadBlock 
$2F OffLine 


An unimplemented command was issued 
Bad call parameter count 
Communications error 

I/O error 

No device connected 

Invalid block number 

Device off-line or no disk in drive 


6.4.3 WRITE BLOCK 


Command Number 


Parameter List 


302 


$03 (parameter count) 

Unit number 

Data buffer (low byte, high byte) 

Block number (low byte, mid byte, high byte) 


The WRITE BLOCK call writes one 512-byte block from memory to the disk 
device specified by the unit-number parameter. The block in memory starts 
at the address specified by the data-buffer parameter. 
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Parameter Descriptions 


Parameter 


Count 


1-byte value 


Unit Number 
1-byte value 


Data Buffer 
2-byte value 


Block Number 
3-byte value 


Possible Errors 
The following errors can be returned by the WRITE BLOCK call: 


301 
$04 
306 
$27 
$28 
$2B 
$2D 
$F 


3 for this call. 


The Protocol Converter assigns each device a unique 
number during initialization (on startup and cold 
reset). The numbers are in the range $01-$7E, and are 
assigned according to the devices’ positions in the 
daisy chain. A unit number of $00 in the STATUS call 
returns the number of devices connected to the 
Protocol Converter. 


Points to the buffer from which the data are to be 
written. 


The logical address of a block of data to be written. 
There is no general connection between block 
numbers and the layout of tracks and sectors on the 
disk. The translation from logical to physical blocks is 
performed by the device. (The most significant byte is 
0 for all devices currently in use.) 


BadCmd An unimplemented command was issued 
BadPCnt Bad call parameter count 

BusErr Communications error 

IOError I/O error 

NoDrive No device connected 

NoWrite Disk write protected 

BadBlock Invalid block number 

OffLine Device off-line or no disk in drive 
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6.4.4 FORMAT 


Command Number $03 


Parameter List $01 (parameter count) 

Unit number 
The FORMAT call prepares all blocks on the recording medium of a block 
device for reading and writing. The formatting done by this call is specific 


to each device and is not linked to any operating system; for exarmple, 
bitmaps and catalogs are not written by this call. 


Parameter Descriptions 


Parameter 

Count 

1-byte value 1 for this call. 

Unit Number The Protocol Converter assigns each device a unique 
1-byte value number during initialization (on startup and cold 


reset). The numbers are in the range $01-$7E, and are 
assigned according to the devices’ positions in the 
daisy chain. A unit number of $00 in the ST ATUS call 
returns the number of devices connected to the 
Protocol Converter. 


Possible Errors 
The following errors can be returned by the FORMAT call: 


$01 BadCmd An unimplemented command was issued 
$04 BadPCnt Bad call parameter count 

$06 BusErr Communications error 

$27 lOError 1/0 error 

$28 NoDrive No device connected 

$2B NoWrite Disk write protected 

$2F OffLine Device off-line or no disk in drive 
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important! 


important! 


6.4.5 CONTROL 


SSS eee eee 
Command Number $04 


Parameter List $03 (parameter count) 
Unit number 
Control list (low byte, high byte) 
Control code 

The CONTROL call sends control information to the device. The 


information can be of a general nature (such as resets or interrupts ), or 
device-specific (such as Download to UniDisk 3.5 RAM). 


A CONTROL call to unit number $00 sends control information to the 
Protocol Converter itself. See the discussions of control code = $00 and 
control code = $01, below. 


Parameter Descriptions 


Parameter 

Count 

1-byte value 3 for this call. 

Unit Number The Protocol Converter assigns each device a unique 

1-byte value number during initialization (on startup and cold 
reset). The numbers are in the range $01-$7E, and are 
assigned according to the devices’ positions in the 
daisy chain. A unit number of $00 in the STATUS call 
returns the number of devices connected to the 
Protocol Converter. Use a unit number of $00 in the 
CONTROL call to send control information to the 
Protocol Converter itself. 

Control List Points to the buffer containing the control information. 

2-byte value The first two bytes (the count bytes, low byte first.) of 


the control list specify the number of bytes in the list 
(not including the count bytes); the remainder of the 
list contains the control information passed to the 
device. 


Every CONTROL call must have a control list; if no control information is 
being passed, then the control list consists of the count bytes only: 


CTRL_LIST DW $8698 
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Control Code The number of the control request being m-ade. 
1-byte value Control codes are in the range $00-$FF. Th e following 
requests are not device specific: 


Code Control Function 


$00 Reset the device 

$01 Set device control block (DCB) 

$02 Set newline status (character devices Only) 
$03 Service device interrupt 


Control requests to unit number $00 are sent to the 
Protocol Converter itself: 


Code Control Function 


$00 Enable interrupts from Protocol Converter 
$01 Disable interrupts from Protocol Converter 


Specific devices may respond to some or alll of these 
additional control requests: 


Code Control Function 


$04 Eject disk 

$05 Runa65C02 subroutine 
$06 Set download address 
$07 Download to device RAM 


Control code = $00 performs a warm reset of the device and generally 
returns “housekeeping” values to some reset value. The control list for this 
call is device dependent. 


The control list for this call for UniDisk 3.5 devices is: 
CTRL_LIST DW $09 No parameters are passed. 


A CONTROL call with control code = $00 and unit number = $00 enables 
interrupts from the Protocol Converter. This informs the firmware that 
external interrupts are possible, and directs it to call the user’s interrupt 
handler if an interrupt occurs. It also turns on the ACIA for port 1. 


When the user’s interrupt handler identifies an external interrupt, you can 
determine if it came from the Protocol Converter by making a STATUS call 
with unit number = $00 and control code = $00 (see Section 6.4. 1). See 
Appendix E for more information on handling interrupts. 
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Newline read mode: See Chapter 4 in the 
ProDOS Technical Reference Manual. 


AWarning 


Control code = $01 alters the contents of the device control block (DCB). 
The DGB is used to set global aspects of a device's operating environment. 
Each device has a default setting for the DCB, set on initialization. Since the 
length of the DCB is device dependent, you should first read in the DCB 
with the STATUS call, then alter the bits of interest, and finally, use the 
same byte string as the control block for the CONTROL call. The first byte 
(the count byte) of the DCB gives the number of bytes in the control block 
(not including the count byte), so the length never exceeds 257 bytes, 
including the count byte. 


Note that because UniDisk 3.5 has no DCB, a Set DCB CONTROL call to 
UniDisk 3.5 returns an error (BadCtl $21). 


A CONTROL call with control code = $01 and unit number = $00 disables 
interrupts from the Protocol Converter. This call turns off the ACIA for port 
1 and sets the least significant bit of the ACIA control register to 0. 


Control code = $02 sets a character device to newline enabled or newline 
disabled. 


Control code = $03 sends a device service interrupt. This code is to be used 
as needed for interrupt-driven devices. 


Control code = $04 ejects a disk. This code is to be used for devices that 
support an auto-eject feature. This code causes UniDisk 3.5 to auto-eject a 
disk. There are no parameters in the control list, and no errors are returned 
if the disk ejected correctly or there was no disk in the drive. Error code $27 
(IOError) is returned if the eject failed—that is, if a disk is still in the drive. 
The control list for UniDisk 3.5 is the following: 


CTRL_LIST DW $9@ No parameters are passed. 


Control codes $05 and higher are reserved; use of some of these codes can 
cause your system to crash. 


Possible Errors 
The following errors can be returned by the CONTROL call: 


$01 BadCmd An unimplemented command was issued 
$04 BadPCnt Bad call parameter count 

$06 BusErr Communications error 

$21 BadCtl Invalid control code 

$22 BadCtlParm Invalid parameter list 

$30-$3F Device-specific errors 
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6.4.6 INIT 


SSS oe 
Command Number = $005 


Parameter List $01 (parameter count) 
$00 (unit number) 


The INIT call resets all intelligent devices attached to the Protocol 
Converter. The Protocol Converter goes through an initialization sequence, 
cold-resetting all devices and sending each its unit number. This call is 
made automatically on startup; an application should never have to make 
this call. 


Parameter Descriptions 


Parameter 

Count 

1-byte value 1 for this call. 

Unit Number 

1-byte value The unit number used in this call is always $00. 


Possible Errors 


The following errors can be returned by the INIT call: 


$01 BadCmd An unimplemented command was issued 
$04 BadPCnt Bad call parameter count 

$06 BusErr Communications error 

$28 NoDrive No device connected 
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6.4.7 OPEN 


SSS) 
Command Number $06 


Parameter List $01 (parameter count) 
Unit number 


The OPEN call prepares a character device for reading or writing. 


Note that since UniDisk 3.5 is a block device, it does not accept this call. An 
attempt to use an OPEN call with UniDisk 3.5 will result in an error 
(BadCmd $01). 


Parameter Descriptions 


Parameter 

Count 

]-byte value 1 for this call. 

Unit Number The Protocol Converter assigns each device a unique 
1-byte value number during initialization (on startup and cold 


reset). The numbers are in the range $01-$7E, and are 
assigned according to the devices’ positions in the 
daisy chain. A unit number of $00 in the STATUS call 
returns the number of devices connected to the 
Protocol Converter. 


Possible Errors 
The following errors can be returned by the OPEN call: 


$01 BadCmd An unimplemented command was issued 
$04 BadPCnt Bad call parameter count 

$06 BusErr Communications error 

$28 NoDrive No device connected 

$2F OffLine Device off-line or no disk in drive 
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6.4.8 CLOSE 


Command Number $07 


Parameter List $01 (parameter count) 
Unit number 


The CLOSE call tells a character device that a sequence of reads or writes is 
over, 


Note that since UniDisk 8.5 is a block device, it does not accept this call. An 
attempt to use a CLOSE call with UniDisk 3.5 will result in an error 
(BadCmd $01). 


Parameter Descriptions 


Parameter 

Count 

1-byte value 1 for this call. 

Unit Number The Protocol Converter assigns each device a unique 
1-byte value number during initialization (on startup amd cold 


reset). The numbers are in the range $01-87E, and are 
assigned according to the devices’ positions in the 
daisy chain. A unit number of $00 in the STATUS call 
returns the number of devices connected te the 
Protocol Converter. 


Possible Errors 
The following errors can be returned by the CLOSE call: 


$01 BadCmd An unimplemented command was issued 
$04 BadPCnt Bad call parameter count 

$06 BusErr Communications error 

$28 NoDrive No device connected 

$oF OffLine Device off-line or no disk in drive 
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6.4.9 READ 


Command Number 


Parameter List 


$08 


$04 (parameter count) 

Unit number 

Buffer pointer (low byte, high byte) 

Byte count (low byte, high byte) 

Address pointer (low byte, mid byte, high byte) 


The READ call reads into memory the number of bytes specified by the 
byte-count parameter. The bytes are placed in a buffer starting at the 
address specified by the buffer-pointer parameter. 


Parameter Descriptions 


Parameter 
Count 
1-byte value 


Unit Number 
1-byte value 


Buffer Pointer 
2-byte value 


Byte Count 
2-byte value 


Address 
Pointer 
3-byte value 


4 for this call. 


The Protocol Converter assigns each device a unique 
number during initialization (on startup and cold 
reset). The numbers are in the range $01-$7E, and are 
assigned according to the devices’ positions in the 
daisy chain. A unit number of $00 in the STATUS call 
returns the number of devices connected to the 
Protocol Converter. 


Points to the buffer into which the data is read. The 
buffer must be large enough to contain the number of 
bytes requested by the byte-count parameter. 


Specifies the number of bytes to be transferred. 


Specifies the address to start reading from. The 
meaning of this parameter depends on the device 
being read. 
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Possible Errors 
The following errors can be returned by the READ call: 


$01 BadCmd An unimplemented command was issued 
$04 BadPCnt Bad call parameter count 

$06 BusErr Communications error 

$27 IOError 1/0 error 

$28 NoDrive No device connected 

$2D BadBlock Invalid block number 

$2F OffLine Device off-line or no disk in drive 


6.4.10 WRITE 


Command Number $09 


Parameter List $04 (parameter count) 

Unit number 

Buffer pointer (low byte, high byte) 

Byte count (low byte, high byte) 

Address pointer (low byte, mid byte, high byte) 
The WRITE call writes from memory the number of bytes specified by the 
byte-count parameter to the specified unit. The bytes in memory start at the 


address indicated by the buffer-pointer parameter. The meaning, of the 
address pointer depends on the type of device (see parameter descriptions). 


Parameter Descriptions 


Parameter 

Count 

1-byte value 4 for this call. 

Unit Number The Protocol Converter assigns each device a unique 
1-byte value number during initialization (on startup and cold 


reset). The numbers are in the range $01-$'7E, and are 
assigned according to the devices’ positions. in the 
daisy chain. A unit number of $00 in the STATUS call 
returns the number of devices connected to the 
Protocol Converter. 
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Buffer Pointer 
2-byte value 


Byte Count 
2-byte value 


Address 
Pointer 


3-byte value 


Possible Errors 


Points to the buffer from which the data is to be 
written. 


Specifies the number of bytes to be transferred. 


Specifies the address to start writing from. The 
meaning of this parameter depends on the device 
being written to. 


The following errors can be returned by the WRITE call: 


$01 
$04 
306 
$27 
$28 
32D 
$F 


BadCmd An unimplemented command was issued 
BadPCnt Bad call parameter count 

BusErr Communications error 

JOError ]/O error 

NoDrive No device connected 

BadBlock Invalid block number 

OffLine Device off-line or no disk in drive 
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6.5 An Example: Issuing a Protocol Converter Call 

aT a et a ee a NOY SC UN a a en eee ee ee 
Here is an example of a program that issues a STATUS call to the Protocol 
Converter to obtain information about a device. 


The code for the Protocol Converter in the version of the Apple IIc that 
supports UniDisk 3.5 always begins at address $C500; however, to ensure 
compatibility with the Apple Ile, your programs should always do a search 
for the Protocol Converter, as in this example. 


0000: | = 

6000: ea * 

0000: 3 * 

8608: 4 * This example shows how to find 

0000: S * and use a PC interface. A search 
0000: 6 * is made for a PC, and when one is 
8600: 7 * found, a vector is set up which 

8000: 8 * points to the PC entry. Thena 

0000: 9 * Device Information Block STATUS call 
0000: 16 * is made, and if successful, the name 
6000: 11 * string embedded in the DIB is output 
6008: 12 * to the screen. Only the first device 
0006: 13 * in the chain is accessed. 

0006: 14 * 

0000: 15 * 

0000: 16 MSB ON 

0000: 17 * 

0000: 18 * 

8000: 8886 19 Z2PTempL equ $9006 ;Temporary zero 
8000: 26 * page storage 
8008: 8887 21 2PTempH equ $8007 

0000: 22 * 

6000: FDED 23 COut equ $FDED ;Console output 
8008: FD8E 24 CROut equ $FD8E ;Carriage return 
0000: 2s * 

6000: 0000 26 StatusCmd equ 0 

0066: e7 * 

0006: 28 * 

0300: 0300 29 org $308 

0300: 36 * 

0300: 31 * Find a Protocol Converter in one of the 
0300: 32 * slots. 

0300: 33 * 

0300:208 43 83 34 jsr FindPC 

§303:B8 1C 0321 35 bes Error 

0306S: 36 * 

6306S: 37 * Now make the DIB call to the first guy 
9305: 38 * 

§9305:289 67 63 39 jsr Dispatch 
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6368: 
0369: 
O30B: 
O836D: 
630D: 
636D: 
O830D: 
O360F: 
O30F: 
6312: 


8314 


9314: 
6314: 
6317: 
9318: 
§31B: 
031D: 
§31D: 
0326: 
0328: 
6326: 
8321: 
9321: 
0321: 
0321: 
9321: 
0321: 
8321: 
9321: 
0323: 
6323: 
06326: 
0328: 
832B: 
032C: 
OB32E: 
O32E: 
B32E: 
O32F: 
O32F: 
6341: 
6343: 
8343: 
9343: 
0343: 
6343: 
9343: 
0343: 
9343: 
6345S: 
6345: 
0347: 


A2 


Ag 
85 


63 
14 


74 


80 


ED 


73 
F2 


8E 


66 
oF 
86 
ED 


FS 


CF 


67 


C7 
67 


8321 


83 


FD 


83 


FD 


3 


FD 


Ag 


O30F 


B30F 


6321 


8323 


B32E 


6323 


B32E 


DO 


6343 


dfb StatusCmd 
dw DParms 
bes Error 
# x 
* Got the DIB; now print the name string 


# 
ldx #9 
morechars equ . 
lda DI BName,x 
ora #$80 ;COut wants high 
. Bit set 
# 
jsr COut 
inx 
cpx DIBNameLen 
blt morechars 
# 
jsr CROut ;Finish it off 
- with a return 
# 
rts 
# 
# 
Error equ . 
# 
* There’s either no PC around, or there 
* was no Unit #1... give message 
# 
ldx #9 
err i equ 7 
lda Message,x 
beq errout 
jsr COut 
inx 
bne err 1 
# 
errout equ ™ 
rts 
# 
Message asc “NO PC OR NO DEVICE’ 


dfb $8D , 0 
# 
# 
FindPC equ * 
# 
Search slot 7 to slot 1 looking for 


# 
* signature bytes 
# 


ldx #7 ;Do for seven 
# slots 

lda *#$C7 

sta ZPTempH 
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8349:A9 880 92 lda *$00 


634B:85 66 93 sta ZPTempL 

034D: 94 * 

834D: 834D 95 newslot equ ‘i 

834D:A8B 67 96 ldy #7 

O34F: 37 * 

O34F: 634F 98 again equ * 

034F:B1 06 99 lda (ZPTempL),y 

9351:D9 78 83 1090 cmp sigtab,y sOne of four 
6354: 161 * byte signature 
8354:F0 67 835D 162 beq maybe ;Found one 
8356: 183 * signature byte 
§8356:C6 67 104 dec ZPTempH 

6358:CA 195 dex 

6359:D8 Fe 934D 1086 bne newslot 

O35B: 107 * 

O@35B: 168 * If we get here, it’s because we couldn’t 
O635B: 109 * find a Protocol Converter. 

O835B: 116 * Exit with the carry set. 

O835B: 111 * 

635B:38 112 sec 

635C:68 113 rts 

93SD: 114 * 

935D: 115 * If we get here, it means that one or 
835D: 116 * more of the signature bytes 

635D: 117 * for this card are what we’re looking 
635D: 118 * for. Decrement the byte 

935D: 119 * counter and branch back to verify any 
635D: 120 * remaining bytes. 

635D: 121 * 

O835D: 835D 122 maybe equ i 

635D:88 123 dey 

635E:88 124 dey If N=1 then 
O35F: 125 * all sig bytes okay 
035F:18 EE 0934F 126 bpl again 

0361: 1e7 * 

9361: 128 * Found a Protocol Converter interface. 
8361: 129 * Set up the call address. 

68361: 136 * We already have the high byte C$CN); 
0361: 131 * we just need the low byte. 

6361: 132 *# 

6361: 9361 133 foundPC equ * 

§8361:A9 FF 134 lda *$FF 

§9363:8S5 06 135 sta ZPTempL 

0365:A0 08 136 ldy a) >For 

9367: 137 * indirect load 
6367:B1 66 138 lda (ZPTempL),y sGet the 
0369: 139 * byte 
0369: 140 * 

9369: 141 * Now the Acc has the low order ProDOS 
9369: 142 * entry point. The PC entry is 

6369: 143 * three locations past this... 
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9369: 
68369: 
B36A: 
836C: 
O836E: 
B3G6E: 
O3G6E: 
O03G6E: 
O836E: 
7:60 
0370: 
6376: 
9376: 
0376: 
0370: 
0376: 
0370: 
0370: 
0374: 
0378: 
0378: 
0378: 
0378: 
037B: 
637B: 
037B: 
037B: 
037B: 
837C: 
037C: 
937D: 
O37F: 
08380: 
0388: 
63886: 
63886: 


O36F 


0381 


18 
69 
85 


18 


FF 
FF 


6C 


83 
6 1 


88 
83 


766 
0384: 
9385S; 
9395: 
0396: 
0397: 
8399: 
9399: 


63 
86 


28 
63 


86 


63 


FF 80 
FF 60 


9378 


637B 


6388 


6018 


144 
145 
146 
147 
148 
149 
156 
151 
152 
153 
154 
155 
156 
157 
158 
159 
168 
161 
162 
163 
164 
165 
166 
167 
168 
169 
176 
171 
172 
173 
174 
175 
176 
177 
178 
179 
188 
181 
182 
183 
184 
185 
186 
187 


cle 
adc #3 
sta ZPTempL 


Now ZPTempL has the PC entry point. 
Return with carry clear. 


s *e¢ & & 


cle 
rts 


These are the PC signature bytes in 
their relative order. 
The $FF bytes are filler bytes and 
are not compared. 


zs es *e* © ee RH 


sigtab dfb $FF,$20,$FF,$08 
dfb $FF,$03,$FF,$00 


+ 
# 
Dispatch equ * 


jmp CZPTempL) >Simulate 


. an indirect JSR to PC 
# 

# 

DParms equ . 

DPParmCt dfb 3 s;Status 

* calls have three parameters 
DPUnit dfb 1 


DPBuffer dw DIB 
DPStatCode dfb 3 


tt 

# 

DIB equ " 
DIBStatBytei dfb 8 


DIBDevSize dfb ,8,0 
DIBNameLen dfb 
DI BName ds 6,9 


DIBSubType dfb 
DIBVersion dw 


0 
0 
1 
DIBType dfb 8 
6 
0 


# 
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6.6 Summary of Commands and Parameters 


ae 


Following is a summary of Protocol Converter calls. In each case, byte 0 of 
the command parameter list (CmdLst) specifies the number of parameters 
in the command list (not including byte 0). Parameters that require more 
than one byte (the status list pointer, for example) are entered low byte 
first. The meaning of the address-pointer parameter is device specific. See 
the sections on the individual calls in this chapter for a discussion of each 
parameter. 


Figure 6-1. Summary of Protocol Converter Calls 


STATUS READBLOCK | WRITEBLOCK | FORMAT CONTROL 

22 Ca ce 
od 
init 


Dg 1 
nee 


Unit Num 

Stat List Ptr Buffer Ptr Buffer Ptr CH List Ptr 
a 

Ln 
ee 
as 


CtLCode 
Block Num Block Num a 
ee 
INIT 


sr s07 0 


Ec PF 
Ql 01 01 504 : 
4 


TQ 

a Ts — Ptr 

i re es en eee 
4S Byte Count Byte Count 
a Cs es eee 
i rr [en Ee eee 
Eee". 
ae: ee ee sae 


Address Ptr Address Ptr 


I 


Unused bytes 
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6.7 Summary of Error Codes 


Following is a summary of Protocol Converter call error codes, including a 
brief description of the possible causes for each. If there is no error, the C 
flag (in the processor status register of the 65C02 microprocessor) is cleared 
(0), and the accumulator (the A register) contains 0s. If the call was 
unsuccessful, the C flag is set (1), and the A register contains the error code. 


$00 
$01 


$04 


$06 


$1] 


$21 


$22 


$27 


$28 


BadCmd 


BadPCnt 


BusErr 


BadUnit 


BadCtl 


BadCtlParm 


IOError 


NoDrive 


6.7 Summary of Error Codes 


No error. 


A nonexistent command was issued. Check 
the command number in the Protocol 
Converter call. 


Bad call parameter count. The call 
parameter list was not properly 
constructed. Make sure the parameter list 
has the correct number of parameters. 


A communications error between the 
device controller and the host. Make sure 
that RAM is both read-enabled and 
write-enabled. Check the hardware (cables 
and connectors) between the device and 
the host. Check for noise sources; make 
sure the cable is properly shielded. 


Unit number $00 was used in a call other 
than STATUS, CONTROL, or INIT. 


The control or status code is not supported 
by the device. 


The control parameter list contains invalid 
information. Make sure each value is within 
the range allowed for that parameter. 


The device encountered an I/O error when 
trying to read or write to the recording 
medium. Make sure that the medium in the 
device is formatted and not defective. Make 
sure the device is operating correctly. 


The device is not connected. This can occur 
if the device is not connected but its 
controller is, or if there is no device with the 
unit number specified. 


14] 
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$2B NoWrite 


$2D BadBlock 


SOF OffLine 


$30-$3F  DevSpec 


$40-$4F 
$50-$7F NonFatal 
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The medium in the device is write 
protected. 


The block number is outside the range 
allowed for the medium in the de vice. Note 
that this range depends on the ty pe of 
device and the type of medium in the 
device (single-sided vs. double-sided disk, 
for example). 


Device off-line or no disk in drive. Check 
the cables and connections; make sure the 
medium is present in the drive, and that the 
drive is functioning correctly. 


Errors that differ from device to device. See 
the technical manual for the device in 
question for details. 


Reserved for future expansion. 


A device-specific soft error. The operation 
completed successfully, but some exception 
condition was detected. See the technical 
manual for the device in question for 
details. 


Chapter 7 Serial I/O Port 1 


143 


AWarning 


Serial port 1 is one of two serial I/O ports available on the Apple IIc. It is 
intended primarily as an output port for RS-232 devices, such as printers 
and plotters. It can be changed to a serial communication port (like port 2) 
either by using the System Utilities disk or from a program. 


Although the Apple IIc serial ports are similar to the Apple Ile Super 
Serial Card, there are important differences. Refer to Appendix F for a 
summary of these differences. 


Table 7-1 summarizes the characteristics of this port if used as a 

printer /plotter port, and is a guide to the other information in this chapter. 
If you change port 1 to a communication port, refer to the descriptions in 
Chapter 8, and use 1 instead of 2 for the port number when required. 


The serial port back panel connectors are described in Section 11.11. 


Table 7-1. Serial Port 1 Characteristics 


Port number: Serial port 1 
Commands: Keyboard command: PR#1 
BASIC command: PR#1 


Monitor command: 1 CONT ROL-P 
(does not work if there is an operating 


system in RAM) 
All other commands: See Table 7-2 
Initial characteristics: See Section 7.2 
Hardware page locations: See Table 7-3 
Monitor firmware routines: None 
I/O firmware entry points: See Table 7-4 
Use of screen holes: See Table 7-5 
Use of other pages: None 
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7.1 Using Serial Port 1 


Te ae 


Refer to Table 7-4 for the standard 
firmware entry points that Pascal 1.1 and 
1.2 use. 


UniDisk 3.5 


You can access the firmware from BASIC in the usual way—that is, by 
issuing CONTROL-D (if DOS or ProDOS is in RAM) and PR#1. Subsequent 
output is directed to the printer (or other device) connected to serial port 1. 


To direct Pascal output to the printer, you can use either #6: or PRINTER: . 


Your programs can also access the port by changing the value of CSW (see 
Chapter 3). 


Table 7-2 lists the commands you can use with serial port 1, either from a 
program or from the keyboard, after you issue PR#1. 


Commands followed by an asterisk in Table 7-2 (with the exception of L) 
are available only on the version of the Apple IIc that supports UniDisk 
3.5. These commands can be toggled by following them directly with E 
(enable) or D (disable). 


Kach command must be preceded by CONTROL-I (the command character). 
As soon as you issue the command character, the serial port firmware 
displays a flashing question mark cursor to indicate it is awaiting a 
command. You do not have to press after commands that you 
have entered from the keyboard, or send RETURN from your program if it is 
sending commands to the port. You can type more than one command on a 
line, but each must be preceded by the command character. 


Table 7-2. Printer Port Commands 
Note: The commands themselves are letter commands, not control characters. 


Command Description 

nnn Sets new line width of nnn (from 1 through 255). This 
command must be followed by N (see below) or by a carriage 
return. 

nnB Sets baud rate to value corresponding to nn: 
nn Rate nn Rate 
1 50 9 1800 
2 15 10 2400 
3 110 (109.92) 11 3600 
4 135 (1384.58) 12 4800 
D 150 13 7200 
6 300 14 9600 
i 600 15 19200 
8 1200 
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Table 7-2—continued. Printer Port Commands 
Note: The commands themselves are letter commands, not control characters. 


Command 


CC 


nD 


F* 


LF 


M* 


nnnN 


Description 


When enabled, this command causes a carriage return 
character to be sent automatically whenever the column 
count exceeds the printer line width. The command is 
normally enabled. 


Sets data format to values corresponding to n: 
Data Stop 
Bits Bits 


! 


“Io OT — © DO ke © = 
oT os —™ CO O11 O3 — CO 
BO BO BO BD ee 


When this command is enabled, your Apple IIc accepts data 
from the keyboard as well as from the serial port. You can use 
this to disable the keyboard before receiving or sending data 
to prevent accidental keystrokes from disrupting the data 
flow. Be sure that your program reenables the key board when 
the data transfer is complete. This command is available only 
from BASIC and is normally enabled. 


Echoes printer output on the screen. 
Disables automatic line feed after carriage return. 


Generates line feed after carriage return. Normallzy, this 
command is enabled. Disabling it has the same effect as the K 
command. 


When this command in enabled, all incoming line feed 
characters are masked (removed from the data stream). 
Normally this command is enabled. 


Changes line width to nnn (from 1 through 255; nran is 
optional); does not echo printer output on the screen. 
Note: ON does not disable automatic generation of carriage 
return; to do so, use Z command, put 0 directly in 

location $0579, or use System Utilities disk. 


Chapter 7: Serial I/O Port 1 


Table 7-2—continued. Printer Port Commands 
Note: The commands themselves are letter commands, not control characters. 


Command Description 


nP Sets parity corresponding to n: 
Parity 


none 
odd 

none 
even 
none 
MARK (1) 
none 
SPACE (0) 


R Resets port 1 (Section 7.2) and exits from serial port 1 
firmware. 


1S) Oo S © MOR © = 


S Sends a 233-millisecond BREAK character (used with some 
printers to synchronize with serial ports). 


X* When enabled, this command turns on the XON/XOFF 
protocol: the Apple IIc looks for the XOFF ($13) character and 
responds by halting transmission until an XON ($11) is 
received. Normally this command is disabled. 


Z Zaps (ignores) further command characters until 


or PR#1. Does not format output or insert 
carriage returns into output stream. 


* Command (with the exception of L) is available only on the version of the Apple IIc that 
supports UniDisk 3.5. Command can be toggled: If you follow the command with E (with 
no intervening space), the command is enabled. If you follow the command with D (with 
no intervening space), command is disabled. The L commanzd is available on the earlier 
Apple IIc, but cannot be toggled there. 


The serial port 1 command character is set as CONTROL-I when the 

Apple IIc is turned on. You can change it to a different control character by 
sending the current control character followed immediately by the new 
control character you want. This is useful if you want to be able to send 
CONTROL-I to the printer without firmware intervention. For example, to 
change the command character from CONTROL-I to CONTROL-V, send 
CONTROL-I CONTROL-V either from the keyboard or a program. 
(CONTROL-V and CONTROL-W are the recommended substitute control 
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characters.) To change the command character back again, send 
CONTROL-V CONTROL-I. Don’t slip any spaces between the control 
characters that you send. 


Do not use CONTROL-A, -B, -C, -H, -J, -L, -M, or -Y: Apple IIc firmware 
may intercept these control characters, causing unpredictable results. 


The following are examples of valid commands and command sequences. 
These examples all show commands being entered from the keyboard, but 
your programs can send the characters just as well. Remember to issue a 
PR#1 before starting to send commands to serial port 1. 


To echo output to the display screen: 

NO) 

To set line width 72, disable line feed, and echo: 
[kK] (2)(NJ 

To change control character to CONTROL-V: 


CONTROL } | || CONTROL RETURN 


To set up the serial port to allow sending CONTROL-I as part of a character 
stream: 


(command) 
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After power-up, the printer firmware sets the following configuration: 


O 9600 baud 

O eight data bits, no parity bits, two stop bits 

oO 80-column line width; no echo to display screen 
o firmware supplies line feed after carriage return 
O command character is set to CONTROL-I 


These values are stored in the auxiliary memory screen holes (Table 7-5). 
You can change some of these settings from the keyboard by typing PR#1, 
the command character, and one of the commands listed in Table 7-2. 
Section 7.6 describes how port characteristics change as a result of various 
activities. 
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7.3 Hardware Page Locations for Port 1 


CEE ne ee 


AWarning 


ACIA stands for asynchronous 
communication interface adapter, a serial 
1/0 chip. Note in Chapter 11 that some of 
the bit assignments for this port differ from 
those for port 2. 


Table 7-3 lists for serial port 1 the addresses and bit assignments of its 
hardware registers on page $CO. The registers are internal to a 6551 ACIA: 
their bit assignments are described in Section 11.11. 


This table is for your information only. To avoid having problems with 
the system, you should never try to directly access the hardware. 
Instead, use the Apple IIc’s built-in firmware in your programs. 


Table 7-3. Port 1 Hardware Page Locations 


Location Description 

$C090-$C097 Reserved 

$C098 ACIA transmit/receive data register 
$C099 ACIA status register 

$CO9A ACIA command register 

$C09B ACIA control register 

$C09C-$C09F Reserved 
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Table 7-4 lists the locations and values of the I/O firmware protocol table. 
This standardized protocol is available for use by any application program. 
Section 3.4.2 describes how to use this protocol. 


Table 7-4. Port 11/0 Firmware Protocol 


Address’ Value Description 

$0105 ~=—s«4$88 Pascal ID byte 

$C107 $18 Pascal ID byte 

$C10B ~—._ $01 Generic signature byte of firmware cards 

$Cl10C ~—_ $81 Same ID as for Super Serial Card 

$C10D _Sii $Clii is entry point of initialization routine (PInit). 
$C10E —s $rr $Clrr is entry point of read routine (PRead). 

$Cl10F  $ww $Clww is entry point of write routine (PWrite). 
$0110 $ss $Clss is entry point of the status routine (PStatus). 
$C111 nonzero No optional routines 
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7.5 Screen Hole Locations for Port 1 
aa NN a a aa OE NE, 


The ACIA register bits are defined in Table 7-5 lists the screen hole locations that serial port 1 uses. Note that the 
Chapter 11. auxiliary memory locations are reserved for startup value settings, which 
are listed and interpreted in the table. 


Table 7-5. Port 1 Screen Hole Locations 


Auxiliary Memory Screen Holes (firmware loads values at power-up): 


Location Description 
$0478 $9E (ACIA control reg: eight data + two stop bits, 
9600 baud) 
$0479 $0B (ACIA command reg: no parity) 
$047A $40 (flags: no echo, auto LF after CR, serial port ) 
Bit Interpretation 
7 Echo output on display (0 = no echo) 
6 Generate LF after CR (0 = no LF) 
5-1 Always = 0 (reserved) 
) 1 = communication port; 0 = serial printer 
port 
$047B $50 (printer width: 80 columns) 
Bit Interpretation 
7-0 Printer width (0 = do not insert CR) 
Main Memory Screen Holes: 
Location Description 
$0479 Reserved 
$04F9 Reserved 
$0579 Printer width (1-255; 0 = disable formatting) 
$05F9 Temporary storage location 
$0679 Bit 7 = 1 while the firmware is parsing a comma.nd string 
$06F9 Current command character (initially CONTROL-I) 
$0779 Bit 7 = 1 if echo to display is on; bit 6 = 1 if firm-ware is to 


generate a line feed after carriage return 


$07F9 Current printer column 
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7.6 Changing Port 1 Characteristics 


CD ESSE a aaa rg a a ea eee eee ae ee) 


Figure 7-1 is a diagram of where the port characteristics are stored and 
moved under different circumstances. You can see the following from the 
figure: 


oO When the power is first turned on, the Monitor reset firmware moves the 
predefined set of port characteristics listed in Section 7.2 from ROM into 
the auxiliary memory screen holes listed in Table 7-5. 


o If you specify new characteristics using the System Utilities disk, the 
SUD software changes the values in the auxiliary memory screen holes. 
Your programs can do the same thing. 


oO The values stored in the auxiliary memory screen holes are affected by 


power-on reset, but not by either or a simple 
(CONTROL }{RESET ]. This feature is provided so that a port that has been 
reconfigured will remain that way while some other program (such as an 
application program) is started up. 


Figure 7-1. Diagram of Port 1 Characteristics Storage 


Port 1 
Values in 


Firmware Locations 


Direct Control 
of interrupt Feat ures 
(See Appendix E) 


System Utilities Disk Printer Port 
PIN Number Selection 


(See Appendix H) 


Commands 
(See Table 7-2) 


Power On 
Reset 


Port 1 
Auxiliary RAM 
Screen Holes 
(See Table 7-5) 


Port 1 
Main RAM 
Screen Holes 
(See Table 7-5) 


Line Width = O Reserved Screen Holes 


Optional Direct 
Program Control 


(G) 
(CONTROL )-(RESET} 


Power On 
Reset 
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oO PR#1 causes the firmware to move the characteristics stored in the 
auxiliary memory screen holes into the main memory screen holes. 


oO A program can change values in the main memory screen holes directly. 
However, the only value guaranteed to be in the same place for the entire 
Apple II series is the line length in main memory location $0579. 

oO The firmware uses the port as it is defined in the main memory screen 
holes at any given time. You should use the commands listed in Table 7-2 
to change them. 


7.6.1 Data Format and Baud Rate 


Se a 
Serial data transfer consists of a string of 1s and 0s sent down a wire at a 
prearranged rate of transmission, called the baud rate. 


Before transfer begins, both sender and receiver look for a continuous value 
of 1: this is called the carrier (Figure 7-2). When the value goes to 0, the 
receiver presumes it is a start bit—that is, the bit that designates the 
beginning of a character of data. If it lasts longer than a bit could possibly 
last, it is considered a BREAK signal, which some printers use for 
synchronization. 


If the first 0 proves to be a bit, it is interpreted as the start bit. Next come 
the seven or eight data bits (six is seldom used with computers), low-order 
bit first. If parity is on, it comes next in the message. Finally, one or two 
stop bits appear. The stop bits have a value of 1, like the carrier. The next 
start bit begins transfer of the next character of data. 


The parity bit provides a simple check of data validity. Odd parity means 
the sender counts the number of 1s among the data bits, and sends the 
appropriate parity bit to make the total number of 1s odd. With ev en parity, 
the sender adds the appropriate parity bit to make the total number of 1 bits 
even. MARK parity is always a 1 bit; SPACE parity is always a0. The 
receiver can then check that the parity bit is correct. 


If the baud rate is 300, and the data format is one start bit plus seven data 
bits plus one parity bit plus one stop bit (totaling ten bits transmitted for 
each byte of data sent), then the actual transfer rate is about 80 characters 
per second. 


Chapter 7: Serial I/O Port. | 


Figure 7-2. Data Format 


| | No 
= 1orMARK 7 Odd { 
Tf 1 Start + Data +¢ Even Parity + Stop 


= Oor SPACE 8 algal 2 
SPACE 


eo LSB MSB Carrier 
1,o}1 1]0,o]/1]/o0}1 ¢ | 
Oo--—-— 
Start Odd Stop Next 
Bit Parity Bit Start 
Bit 


ASCIl letter M = $4D; sent as 8 data, odd parity, 1 stop bit. 


7.6.2 Carriage Return and Line Feed 
SSS Sa ae ee ee ee en er 


If you are using a typewriter and you push the carriage all the way to the 
right (in other words, position the printing mechanism at the left margin), 
you have performed a carriage return. On the other hand, turning the platen 
so the paper moves to the next line (or using the index key on an electric 
typewriter) is called a line feed. Most typewriters perform a line feed 
automatically after a carriage return, and so the two seem to be one—but 
they are not. 


Carriage return and line feed are separate ASCII codes. Carriage return is 
sometimes denoted CR; it is ASCII code 13 ($0D). Line feed, sometimes 
denoted LF, is ASCII code 10 ($0A). 4] on the Apple IIc keyboard generates 
a LF. 


some printers can supply a line feed automatically after detecting a 
carriage return; others cannot. If the printer does not supply a line feed after 
a Carriage return and it is not supplied in the data stream, the printer keeps 
printing over and over on the same line. On the other hand, if both the 
printer and the Apple IIc firmware supply LF after CR, double line-spacing 
results. 


If the print head keeps moving too far to the right across the page and then 
prints many characters on top of one another on the right, then the 
firmware should be instructed to furnish CR after a certain line width has 
been reached. If the printer prints too short a line before moving to the next 
line, then probably the firmware is using too small a line width. 
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If the printer misses characters at the beginning of each line but otherwise 
prints correctly, there is probably not enough time for the print mechanism 
to return to the left margin in response to CR. You must use a lower baud 
rate with such a printer. 


7.6.3 Sending Special Characters 
SSE eee ee eee 


If you want to send special characters (control characters) to the printer 
without having them intercepted and executed by the Apple IIc firmware, 
use the Z command (see Table 7-2). If the only special character that causes 
a problem is the command character (normally CONTROL-I for port 1), you 
can change just the command character instead of using the zap (Z) 
command. If you use the zap command, the firmware does no formatting: 
that is, it does not check line width or insert carriage returns or line feeds. 
This may be necessary to send graphics to a printer or plotter. 


7.6.4 Displaying Output on the Screen 
a) se ee Oe ee an ans 


You can display printer output on the screen, but if the printer line width 
exceeds the 40 or 80 columns you have selected for display, you should turn 
off video display. 
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Chapter 8 serial 1/0 Port 2 
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Serial port 2 is one of two serial I/O ports available on the Apple IIc. It is 
intended primarily as a communication port for modems. You can change it 
to a serial printer port (like port 1) using the System Utilities disk or from a 
program. 


AWarning Although the Apple IIc serial ports are similar to the Apple Ile Super Serial 
Card, there are important differences. Refer to Appendix F for a summary 
of these differences. 


Table 8-1 summarizes the characteristics of this port and is a guide to the 
other information in this chapter. If you change port 2 to a serial printer 
port, refer to the descriptions in Chapter 7, and use 2 instead of 1 for the 
port number when required. 


The serial port connectors are described in Section 11.11. 


Table 8-1. Serial Port 2 Characteristics 


Port number: Serial port 2 


Commands: Keyboard commands: 
IN#2 before Table 8-2 commands 
IN#2 to accept port 2 input 
PR#1 to echo input to printer 
PR#2 to echo input back to port 2 


BASIC commands: same 


Monitor command: 2 CONTROL-P 
(does not work if there is an. operating 
system in RAM) 


All other commands: See Table 8-2 


Initial characteristics: See Section 8.2 

Hardware page locations: See Table 8-3 

Monitor firmware routines: None 

I/0 firmware entry points: See Table 8-4 

Use of screen holes: See Table 8-5 

Use of other pages: In terminal mode, firmware uses 


auxiliary memory locations 
$0800-$087F to store keyboard input, 
and $0880-$08FF as a serial input 
buffer. 
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8.1 Using Serial Port 2 


SS ee a a ar ren 


important! 


Refer to Table 8-4 for the standard 
firmware entry points that Pascal 1.1 and 
1.2 use. 


UniDisk 3.5 


You can access the firmware from BASIC in the usual way—that is, by 
issuing CONTROL-D (if DOS or ProDOS is in RAM) followed by IN#2 or 
PR#2. Subsequent input and output are routed through the modem (or other 
device) connected to serial port 2. 


In terminal mode, the modem port commands listed in Table 8-2 must 
follow CONTROL-D and IN#2 (not PR#2) and the command character 
(which is usually CONTROL-A). 


To transfer files to the modem under Pascal, specify REMOUT: or #8: . To 
transfer files from the modem under Pascal, specify REMIN: or #7: . 


Table 8-2 lists the commands you can use with serial port 2, either from a 
program or from the keyboard, after you issue IN#2. 


Commands followed by an asterisk in Table 8-2 (with the exception of L) 
are available only on the version of the Apple IIc that supports UniDisk 
3.5. These commands can be toggled by following them directly with E 
(enable) or D (disable). 


Each command must be preceded by CONTROL-A (the command 
character). As soon as you issue the command character, the serial port 
firmware displays a flashing question mark cursor to indicate it is awaiting 
a command. If you press [RETURN], you get the current video cursor again. 
You do not have to press (or send a RETURN character) after 
commands. You can type more than one command on a line, but each must 
be preceded by the command character. 


Table 8-2. Modem Port Commands 
Note: The commands themselves are letter commands, not control characters. 


Command Description 
nnn Sets new line width of nnn (from 1 through 255); this must be 
followed immediately by N (see below) or by carriage return. 
nnB Sets baud rate to value corresponding to nn: 
nn Rate nn Rate nn Rate 
1 50 6 300 11 8600 
2 15 (| 600 12 4800 
3 110 (109.92) 8 1200 13 = 7200 
4 135 (184.58) 9 1800 14 9600 
D 150 10 =. 2400 15 = 19200 
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Table 8-2—continued. Modem Port Commands 
Note: The commands themselves are letter commands, not control characters. 


Command 


CC 


nD 


F* 


| Fi 


M* 


nnnN 


Description 


When enabled, this command causes a Carriage return 
character to be sent automatically whenever the column 
count exceeds the printer line width. The command is 
normally enabled. 


Sets data format to values corresponding to n: 


Data Stop 
n Bits Bits 
0 8 l 
l { l 
2 6 ] 
3 5 | 
4 8 2 
5 1 2 
6 6 2 
fi 5 2 


When this command is enabled, your Apple IIc accepts data 
from the keyboard as well as from the serial port. You can use 
this to disable the keyboard before receiving or sending data 
to prevent accidental keystrokes from disrupting the data 
flow. Be sure that your program reenables the keyboard when 
the data transfer is complete. This command is available only 
from BASIC and is normally enabled. 


Echoes output on the screen. 
Disables automatic line feed after carriage return. 


Generates line feed after carriage return. Normally, this 
command is enabled. Disabling it has the same effect as the K 
command. 


When this command in enabled, all incoming line feed 
characters are masked (removed from the data stream). 
Normally this command is enabled. 


Sets line width to nnn (from 1 through 255); does not echo 
output on the screen. Note: ON does not disable automatic 
generation of carriage return; to do so, use Z command, put 0 
directly in location $057A, or use System Utilities disk. 
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Table 8-2—continued. Modem Port Commands 
Note: The commands themselves are letter commands, not control characters. 


Command 


nP 


x? 


[CONTROL }{R] 


Description 


Sets parity corresponding to n: 
Parity 


none 
odd 

none 
even 
none 
MARK (1) 
none 
SPACE (0) 


Quits terminal mode. 


Jo of CO POF © = 


Resets port 2 (Section 8.2) and exits from serial port 2 
firmware. 


Sends a 233-millisecond BREAK character. 


Enters terminal mode. Use this command after IN#2 only. 
Also, if you follow this command by PR#2, the Apple IIc 
echoes input to output. (If the other device does so too, the 
first character loops endlessly, locking up the system. Use 
to get out.) 


When enabled, this command turns on the XON/XOFF 
protocol: the Apple IIc looks for the XOFF ($13) character and 
responds by halting transmission until an XON ($11) is 
received. Normally this command is disabled. 


Zaps (ignores) further command characters until 


(RESET). Does not format output or insert carriage 
returns into output stream. 


This command from a remote device puts the Apple IIc in 
terminal mode if IN#2 is already in effect. It is the same as 
typed locally. 


This command from a remote device undoes the terminal 
mode command. If IN#2 and PR#2 are in effect, the remote 
keyboard and display become the input and output devices of 


the local Apple IIc. It is the same as [a] typed 
locally. 


* Command (with the exception of L) available only on the version of the Apple IIc that 
supports UniDisk 3.5. Command can be toggled: If you follow the command with E (with 
no intervening space) the command is enabled. If you follow the command with D (with 
no intervening space) the command is disabled. The L command is available on the 
earlier Apple IIc, but it cannot be toggled there. 
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When the Apple IIc is turned on, the serial port 2 command character is 
defined as a CONTROL-A. You can change it to a different control character 
by typing the current control character followed immediately by the new 
control character you want. This is useful if you want to be able to send 
CONTROL-A to the output device without firmware intervention. 


For example, to change the command character from CONTROL-A to 
CONTROL-V, send CONTROL-A CONTROL-V either from the keyboard or a 
program. (CONTROL-V and CONTROL-W are the recommended substitute 
control characters.) To change the command character back again, send 
CONTROL-V CONTROL-A. 


Do not use CONTROL-B, -C, -H, -I, -J, -L, -M, or -Y: Apple IIc firmware may 
intercept these control characters, causing unpredictable results. 


The following are examples of valid commands and command sequences. 
These examples all show commands being entered from the keyboard, but 
your programs can send the characters just as well. 


To enable echo to the screen: 
CONTROL (1) 


To send a BREAK character to a remote device: 


CONTROL 


To change the control character to CONTROL-V (for example, so you can 
send CONTROL-A as part of a character stream): 


‘CONTROL CONTROL CONTROL (command) 
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After power-up, the firmware sets the following configuration: 


300 baud 

eight data bits, no parity bits, one stop bit 

firmware does not supply line feed after carriage return 
firmware does not insert carriage returns into output stream 
firmware does not echo output to the display screen 
command character is set to CONTROL-A 


OOO00 0 


Chapter 8: Serial I/O Port 2 


These values are stored in the auxiliary memory screen holes (Table 8-5). 
You can change some of these settings from the keyboard using the 
command character followed by one of the commands listed in Table 8-2. 
Section 8.6 describes how port characteristics change as a result of various 
activities. 


If you change any of these values using keyboard commands or commands 
from a program, subsequent accesses to the port firmware (even by another 
program) use the new settings instead of the power-up values. This allows 
you to change the settings once at system startup, and get the desired 
configuration for subsequent uses. Refer to Section 8.6 for a complete 
description of these processes. 


8.3 Hardware Page Locations for Port 2 


FT ee 


AWanrning 


ACIA stands for asynchronous 
communication interface adapter, a serial 
I/O chip. Note in Chapter 11 that some of 
the bit assignments for this port differ from 
those for port 1. 


Table 8-8 lists for serial port 2 the addresses of its hardware registers on 
page $C0. The registers are internal to a 6551 ACIA; their bit assignments 
are described in Section 11.11. 


This table is for your information only. To avoid having problems with 
your system, you should never try to directly access the hardware. 
Instead, use the Apple IIc’s built-in firmware in your programs. 


Table 8-3. Port 2 Hardware Page Locations 


Location Description 

$COA0-$COAT7 Reserved 

$COA8 ACIA transmit/receive data register 
$COA9 ACIA status register 

$COAA ACIA command register 

$COAB ACIA control register 
$COAC-$COAF Reserved 
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Table 8-4 lists the values in the I/O firmware protocol table for serial port 2. 
This standardized protocol is available for use by any application program. 
Section 3.4.2 describes how to use this protocol. 
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Table 8-4. Port 2 1/0 Firmware Protocol 


Address Value Description 

$C205 —s-: $88 Pascal ID byte 

$C207 ~—s-« $18 Pascal ID byte 

$C20B $01 Generic signature byte of firmware cards 

$C20C ~—s._: $81 Same ID as for Super Serial Card 

$C20D $i $C2ii is entry point of initialization routine CPInit). 
$C20E $rr $Carr is entry point of read routine (PRead) . 

$C20F $ww $C2ww is entry point of write routine (PWrite). 
$C210 $ss $C2ss is entry point of the status routine (PStatus). 
$C211 nonzero No optional routines 


8.5 Screen Hole Locations for Port 2 
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The ACIA register bits are defined in Table 8-5 lists the screen hole locations that serial port 2 uses. Note that the 
Chapter 11. auxiliary memory locations are reserved for startup value settings, which 
are listed and interpreted in the table. 


Table 8-5. Port 2 Screen Hole Locations 


Auxiliary Memory Screen Holes (firmware loads values at power-up) : 


Location Description 
$047C $16 (ACIA control reg: eight data + one stop bit, 300 baud) 
$047D $0B (ACIA command reg: no parity) 
$047E $01 (flags: no echo, no auto LF after CR, commun ication 
port) 
Bit Interpretation 
(| Echo output on display (0 = no echo) 
6 Generate LF after CR (0 = no LF) 
5-1 Always = 0 (reserved) 
0 1 = communication port; 0 = serial printer 
port 
$047F $00 (line length: do not add any CR to output stream) 
Bit Interpretation 
7-0 Line length (0 = do not insert CR) 
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Table 8-5—continued. Port 2 Screen Hole Locations 


Main Memory Screen Holes: 


Location Description 

$047A Reserved 

$04FA Reserved 

$057A Line length (1-255; 0 = disable formatting) 

$05FA Temporary storage location 

$067A Bit 7 = 1 if and only if the firmware is currently parsing a 
command string 

$06FA Current command character (initially CONTROL-I) 

$O77A Bit 7 = 1 if echo to display is on; bit 6 = 1 if firmware is to 


generate a line feed after carriage return 


$O7FA Current column 


8.6 Changing Port 2 Characteristics 

ES i ——  — ————————————————————————— a ee 
Figure 8-1 is a diagram of where the port characteristics are stored and 
moved under different circumstances. You can see the following from the 
figure: 


O 


When the power is first turned on, the Monitor reset firmware moves the 
predefined set of port characteristics listed in Table 8-2 from ROM into 
the auxiliary memory screen holes listed in Table 8-5. 


If you specify new characteristics using the System Utzlitzes disk, the 
utility software changes the values in the auxiliary memory screen holes. 


The values stored in the auxiliary memory screen holes are affected by 
power-on reset, but not by either or a simple 
(CONTROL }{ RESET ]. This feature is provided so that a port that has been 
reconfigured will remain that way while some other program (such as an 
application program) is started up. 

IN#2 causes the firmware to move the characteristics stored in the 
auxiliary memory screen holes into the main memory screen holes. 

A program can change values in the main memory screen holes directly. 
However, the only value guaranteed to be in the same place for the entire 
Apple II series is the line length in main memory location $057A. 
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Figure 8-1. Diagram of Port 2 Characteristics Storage 
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oO The firmware uses the port as it is defined in the main memory screen 
holes at any given time. You should use the commands listed in Table 8-2 


to change these characteristics. 


8.6.1 Data Format and Baud Rate 


Section 7.6.1 describes data format and baud rate, and explains how they 
apply to printers. Refer to that section for definitions of terms. 


A noteworthy characteristic of data communication is its strangeness: 
sometimes the oddest changes make a given communication arrangement 
work or not work. You must keep this notion firmly in mind when working 


with serial port 2. 
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For example, modem communication involves quite a few elements 

(Figure 8-2): 

oO the Apple IIc and its firmware, with the baud rate, data format, and other 
characteristics you have selected 

the cable from the Apple IIc to the modem 

the modem 

possibly an acoustic coupler for a telephone handset 

the telephone lines, with their switching equipment, boosters, and noise 
O some combination of modem, cable, and remote computer or terminal 


D Od Od 


As you Can imagine, some method is required for successful data 
transmission. If you have problems, change only one variable at a time, and 
then cycle through the other variables one at a time. Take nothing for 
granted. The data format advertised for an information service, for 
example, may be different from the one you end up using with the 

Apple IIc. 


Figure 8-2. Devices in a Typical Communication Setup 
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For a further description of what terminal 
mode does and how to get into and out of it, 
refer to the last section of this chapter. 
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8.6.2 Carriage Return and Line Feed 
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If you are communicating with a computer or terminal, carriage return and 
line feed may or may not be involved. Start off without generating them, 
and turn on automatic generation only as needed. They are described as 
used with printers in Section 7.6.2. 


8.6.3 Routing Input and Output 
SSeS een en 


This section discusses the possible ways that serial port 2 can route 
information. Sometimes the cause of communication problems is that 
information is not going where you think it is, or it is and you cannot see 
evidence of the fact. Figures 8-3 through 8-6 show some of the patterns of 
information flow you can select. This section and the following subsections 
tell you how to use them. 


It is best to read all this material as a unit: questions that arise while you 
read one description may be answered elsewhere. 


The simplest serial port 2 command is IN#2 (Figure 8-3). Port 2 becomes the 
input device. Data coming into the port gets passed to the input buffer 
(page $02 of main memory). Applesoft firmware and system software can 
see the data and carry out commands in the normal way. 


Of course, you can also use just the PR#2 command—for example, if you 
want to send a listing to the modem. 


To use port 2 for data communication, you ordinarily put it into terminal 
mode. Following IN#2, pressing gets the attention of the 
port 2 firmware, which displays a blinking question mark (?) as a prompt. 
Now type T to put the computer in terminal mode. In this mode, the 
firmware displays a blinking underscore character ( _ ) as a prompt. 


In the discussion that follows, /oca/ refers to your Apple IIc. Revmote refers 
to some other device, usually in a distant location and at the other end of a 
communication link. The remote device can be any ASCII-generating unit: a 
terminal or a computer. 


If a remote computer is another Apple IIc or an Apple II series machine with 
a Super Serial Card in it, then most of the commands described here apply 
to it as well. 
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Figure 8-3. Effect of IN#2 
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Half-Duplex Operation 


In half-duplex operation, information can flow from A to B or from B to A, 
but in only one direction at a time. In a half-duplex setup, the host does not 
echo back to the terminal what the terminal sends it. For half-duplex 
operation, use IN#2 and CONTROL-A T (Figure 8-4) whether the Apple IIc 
is the host or the terminal. 


IN#2 plus CONTROL-A T is the best way to set up the computer for 
auto-answer operation. The T command allows port 2 firmware to exchange 
information with the local modem without interference from the local 
firmware or system software. (The remote device can always cancel the 

T command with CONTROL-R if necessary, and restore terminal mode with 
CONTROL-T.) Avoiding PR#2 at this point means that the Apple IIc can 
operate as a half-duplex terminal, half-duplex host, or full-duplex terminal. 
(The remote device can also issue CONTROL-A PR#2 if PR#2 is required at 
the local computer. ) 
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Figure 8-4. Effect of IN#2 and T Command (Half Duplex) 
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In half-duplex operation, the output hook is available for other uses. For 
example, you can issue PR#1 to print incoming messages from port 2. Use 
the CONTROL-A I command to display information on the screen . 


Full-Duplex Operation 


In full-duplex operation, information can flow from A to B and from B to A 
simultaneously. Typically, one of the computers (the host computer) echoes 
its input to output, so the other computer (the terminal) can easily verify 
that the communication is taking place. 


Figure 8-5 shows the flow of information when the Apple IIc is a full-duplex 
terminal. (The setup commands, IN#2 and CONTROL-A T, are the same as 
for half duplex.) 
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Figure 8-5. Effect of IN#2 and T Command (Full-Duplex Terminal ) 


Display 


t 


PR# 1) os = 


Keyboard 


Communication 
Device 


Remote 
Communication 
Device 


2 an 


Remote 
Terminal 
or Computer 


If your Apple IIc is the terminal in full-duplex operation, use the 

N command to turn off echoing input to the screen. If the Apple IIc does 
echo input to the screen in this setup, everything you type will appear 
twice: once from the Apple IIc and once from the host computer. 


In this mode of operation, if you echo input to the printer you can get a 
printed record of both sides of the communication session: the input from 
the host, and the Apple IIc output as echoed by the host. 


Figure 8-6 shows the flow of information when the Apple IIc is a full-duplex 
host. In this case, the local Apple IIc must echo input to output for the 
remote device. The setup commands include PR#2 in this case. 


8.6 Changing Port 2 Characteristics 


169 


Figure 8-6. Effect of IN#2, PR#2, and T Command (Full-Duplex Host) 
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AWarning If the Apple IIc echoes input to output and the other computer does too, 
then the first subsequent keypress will echo back and forth en dlessly and 


lock up the Apple IIc. This will require a to get out. 


If you echo input to output when using an information service, the host 
will end up seeing the echo of what it sent you as though you Imad typed 
it. 

In this arrangement, the local output hook is not available for usimg the 


printer or other device. To display keyboard and port 2 input on the screen, 
issue CONTROL-A I. 
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AWarning 


Terminal Mode 


Terminal mode makes the Apple IIc act like a dumb terminal—one that just 
sends and receives information, but does not process it. Input and output 
flow through special serial I/O buffers on page $08 of auxiliary memory. 
Applesoft firmware and system software cannot see or interpret the data: 
only the serial port 2 firmware deals with it. 


In most terminal mode setups, the firmware will not display port 2 input 
unless you use the CONTROL-A I command. 


When using terminal mode, $0800-$08FF of auxiliary RAM is used for 
buffering. Any data stored there will be overwritten when terminal mode 
is enabled. 


CONTROL-A T turns on terminal mode, and CONTROL-A Q turns it off. 


The remote device can go into terminal mode, and then turn off the local 
Apple IIc’s terminal mode with the CONTROL-R command. If it then issues 
CONTROL-A PR#2, local output will go to the remote device. The remote 
keyboard and display then become the input and output devices of the local 
Apple IIc processor. This is remote mode. 


In remote mode, the local Apple IIc does not use the serial I/O buffers (as it 
does in terminal mode); therefore, local firmware and system software 
detect and interpret all input and output data. So, for example, if you type 
CATALOG at the remote device keyboard, the local Apple IIc will execute 
the command and list the disk catalog on the remote device’s display. (In 
terminal mode, the local computer would simply display the word 
CATALOG on its screen. ) 


The remote device can turn the local Apple IIc’s terminal mode back on 
with CONTROL-T. CONTROL-A T issued at the remote device only turns on 
the remote device’s terminal mode, unless the command character there 
has already been changed to something else. 
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This chapter describes the Apple IIc’s mouse port and hand controller 
(game) input capabilities. The mouse and hand controllers use the same 
9-pin connector on the back panel; the firmware uses the port as directed by 
keyboard or program commands. 


A program can tell if a hand controller is connected (Section 9.2) but not if a 
mouse is connected, unless the computer user moves it. 


9.1 Mouse Input 

I 0 ee ee Rg | 
Table 9-1 summarizes the mouse port’s characteristics and guides you to 
other information in this part of the chapter. 


AWarning If you want your programs that use the mouse on the Apple Ile and other 
Apple II series computers to work with the Apple IIc, always use the I/O 
firmware entry points listed in Tables 9-4 and 9-5, rather than dealing 
directly with the mouse hardware and RAM locations. 


The mouse back panel connector is described in Section 11.12. 


Table 9-1. Mouse Input Port Characteristics 


Port number: Mouse input port 4 

BASIC commands: Turn on mouse: 
PRINT CHR$(4)“PR#4”:PRI NT 
CHR$(1) 


Turn off mouse interrupts: 

PRINT “PR#4”:PRINT CHR$(0) 
Turn on graphics character set: See 
Section 5.2.2. 


Initial characteristics: After a reset, all mouse inte rrupts are 
off, and the rising edge of XO and YO 
are selected for interrupts. 


Hardware page locations: See Table 9-2 

Monitor firmware routines: None 

I/O firmware entry points: See Table 9-3 and Table 9-4 
Use of screen holes: See Table 9-5 
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9.1.1 Mouse Connector Signals 


The mouse uses the same DB-9 connector as the hand controllers. However, 
the interpretation of the signals arriving on the pins differs depending on 
the commands and signals received. Figure 11-37 shows the names of the 
pin assignments when a mouse is connected. 


9.1.2 Mouse Operating Modes 


SSeS ee Se eS ee SSS eS SSS 
This section tells what the mouse operating modes are for. Later sections of 
this chapter describe how to set the various mouse operating modes. 


Your program should call the ServeMouse routine to determine the source of 
an interrupt as soon as it receives one, in all the interrupt modes except 
transparent mode. 


Transparent Mode 


In transparent mode, your program must read screen holes to check for 
mouse movement. An interrupt routine in the Apple IIc firmware updates 
mouse position counters each time the mouse is moved, then returns control 
to the main program task. The findings of the interrupt routine are placed in 
the screen holes for your program to find. Table 9-5 lists the screen holes 
with the information that your program should look for. 


This is the only mouse mode available to BASIC programs. 


Movement Interrupt Mode 


On the Apple IIc, a signal called VBlInt can interrupt the processor 
whenever a video vertical blanking signal occurs. This can make it easier 
for your programs to smoothly move the mouse cursor in response to mouse 
movements. 


In movement interrupt mode, the mouse firmware arms VBlInt whenever 
the mouse is moved at least one count in any direction. When VBlInt 
occurs, program control passes to the vector address contained at 

locations $08FE and $03FF; the interrupt handler in your program can then 
update the cursor smoothly to its next screen position. 


9.1 Mouse Input yes: 


Section 5.2.2 contains recommendations for 
using MouseText characters with a mouse. 


Appendix E explains how the firmware 


handles interrupts. 
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Your program’s interrupt handler must first call ServeMouse (Table 9-3) to 
see if the mouse caused the interrupt. It should then call ReadMouse to get 
mouse status and its current X-Y position. The routine can also c hange the 
mouse mode and position if desired. 


The maximum amount of mouse movement that can occur between 
successive VBL interrupts is limited to the distance someone can move a 
mouse in one-sixtieth of a second. 


Button Interrupt Mode 


The Apple IIc mouse-button hardware location does not generate interrupts. 
However, a program can simulate mouse-button interrupts by polling the 
button whenever VBlInt occurs, and acting on the interrupt whenever the 
button state has changed. This lets your program provide fast response to 
the mouse movement without too much program overhead. 


Movement/Button Interrupt Mode 


The movement/button interrupt mode is a combination of the two modes 
just described. It provides the best response possible without constant 
polling of the mouse position and button. Your program can effectively 
process a main task concurrently with cursor and menu updating, as well as 
menu-selected command processing. 


Vertical Blanking Active Modes 


The vertical blanking active modes are the same as the four just described 
except that they allow VBL interrupts to be sent to the user. 


9.1.3 Mouse Soft Switches 


a ee a ee | 

The soft switches assigned to the mouse interface are shown in Table 9-2. 
On power-up or reset, the hardware selects the rising edge of X0 and Y0 
(mouse movement signals) and masks out all mouse interrupts. 


Table 9-2 is included here for your information only. You should use the 
built-in firmware to access the mouse; doing so is much easier than 
writing your own mouse interrupt handler, and guarantees cormpatibility 
with all other Apple II series computers. 
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Table 9-2. Mouse Soft Switches 


Name Action Hex Function 

IOUDis W $CO7E On: Disable IOU access for addresses $C058 to 
$CO5F; enable access to DHiRes switch* 

IOUDis W $CO7F Off: Enable IOU access for addresses $C058 to 


$CO5F: disable access to DHiRes switch* 
RdIOUDis RT $CO7E Read IOUDis switch (1 = off)* 


DisXY R/W $C058 Disable (mask) X0 and YO movement 
interrupts*** 

EnbXY R/W $C059 ~~ Enable (allow) X0 and YO movement 
interrupts** 

RdXYMsk ~—— R77 $C040 Read status of X0/Y0 interrupt mask 
(1 = mask on) 

RstXY R $C048 Reset X0/Y0 interrupt flags 


X0Edge R/W $C05C Select rising edge of X0 for interrupt** 
X0Edge R/W $C05D Select falling edge of XO for interrupt*** 
RdX0Edge  R7 $C042 Read status of XO edge selector (1 = falling) 
RstXInt R $C015 Reset mouse XO interrupt flag 


YOEdge R/W $CO5E —_— Select rising edge of YO for interrupt** 
YOEdge R/W $CO5F — Select falling edge of YO for interrupt** 
RdYOEdge  R7 $0043 Read status of YO edge selector (1 = falling) 


RstYInt R $C017 Reset mouse YO interrupt flag 

DisVBI R/W $CO5A Disable (mask) VBL interrupts** 

EnVBI R/W $C05B —_— Enable (allow) VBL interrupts*** 

RdVBIMsk R7 $C041 Read status of VBL interrupt mask (1 = mask 
on) 

Rst VBI R $C019 Read and then reset VBlInt flag 

PTrig R/W $C070 —_—- Reset VBlInt flag: trigger paddle timer 
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Table 9-2—continued. Mouse Soft Switches 


Name Action Hex Function 
RdBtn0 R7 $C061 ‘Read first mouse button status (1 = pressed)t 
Rd63 R7 $0068 Read second mouse button status 
(0 = pressed )t 
MouX1 R7 $C066 —_- Read status of X1 (mouse X direction) 
(1 = high) 
MouY1 R7 $C067 Read status of Y1 (mouse Y direction) 
(1 = high) 
* When IOUDis is on, $C058-$CO05F do not affect mouse, and $CO5E and $C05 F become 
DHiRes (Table 5-8). 


** Read or write to $C07x also resets VBlInt and triggers paddle timers. 
*“* These work only if IOUDis is off. 

+ This location is also the (G) key (Table 4-1). 

t This is also the location of the shift-key mod (Appendix F). 


Mouse firmware sets interrupts in response to mode settings under program 
control. The vertical blanking interrupt (VBlInt) is armed if the mouse 
button is pushed or moves at least a count of 1 in the X0 or YO coordinates. 
Read $C070 to reset the VBL interrupt. Because a VBL occurs every sixtieth 
of a second, that is the maximum time that can elapse before the resulting 
interrupt can be acknowledged and acted upon. 


Software can also select which edge of X0 and Y0 information will cause the 
XInt or YInt. 


When an interrupt has occurred, you can read the direction of the mouse’s 
X1 movement by reading address $C066 bit 7, and Yl movement by reading 
address $C067 bit 7. 


A program can read the status of the soft switches by reading one of the 
locations $C040-$C048 and then testing data bit 7. 


Section 11.12 explains what X0, YO, X1, Yl are and what they mean with 
respect to mouse movement. 


If you write your own mouse interrupt handler, it should enable the main 
bank-switched memory, set up its own IRQ vectors at addresses SF FFE and 
$FFFF, keep track of video modes and the alternate stack, and check for 
the interrupt source in the same manner as the mouse firmware listed in 
Appendix I, beginning at address $C400. 
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UniDisk 3.5 


The 382K ROM includes a new feature for programs that need to use 
mouse interrupts for their own purposes. If your program sets bit 7 of the 
mouse port mode byte at $07FC to 1, mouse movement interrupts will be 
passed to the interrupt handler of your program. VBL interrupts will still 
be handled by the Apple IIc’s firmware. You should use this feature only 
if the mouse firmware can’t keep up with your needs. 


9.1.4 |/O Firmware Support for Mouse Input 
SSE ee eee ee ee ee 


The Apple IIc supports the mouse with firmware starting at address $C400. 
This firmware is necessary because the mouse requires fast, transparent 
interrupt processing to work effectively. 


In assembly language you can use direct firmware support for sophisticated 
mouse applications. To enable the mouse, first load a mode byte into the 
accumulator (and $C4 in X, $40 in Y), and then do a JSR to the firmware 
routine called SetMouse (Table 9-3). Valid mode bytes are the following: 


$00 Turns mouse off. 

$01 Sets transparent mode. 

$03 Sets movement interrupt mode. 

$05 Sets button interrupt mode. 

$07 Sets movement or button interrupt mode. 

$08 Turns mouse off, VBlInt active. 

$09 Sets transparent mode, VBlInt active. 

$0B Sets movement interrupt mode, VBlInt active. 

$0D Sets button interrupt mode, VBlInt active. 

SOF Sets movement or button interrupt mode, VBlInt active. 


The firmware then initializes the mouse. To read the current position and 
status of the mouse, first load $C4 into the X register, load $40 into the Y 
register, save processor status, disable interrupts, and then JSR to the 
firmware routine called ReadMouse (Table 9-8), which stores the 
information in the port 4 screen holes (Table 9-5). 


Table 9-3 lists the mouse port firmware routine offsets. Each address 
contains the low byte of the entry point of the routine described. The calling 
setup for all routines (except ServeMouse) is the same: the X register must 
contain $C4, and the Y register must contain $40. When the routine has 
finished, the A, X, and Y register contents are undefined. 
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Table 9-3. Mouse Firmware Routines 


Location Offset for 


$0412 


$0413 


$0414 


$0415 


$0416 


$0417 


$0418 


$0419 


SetMouse 


ServeMouse 


ReadMouse 


ClearMouse 


PosMouse 


ClampMouse 


HomeMouse 


InitMouse 


Description 


Sets the mouse mode to the value in the accumulator. 
Input: A register contains mode (see $07FC, Table 9-5). 
Output: Carry bit = 0 means mode was lega]; carry 

bit = 1 means mode was not legal. 


Services mouse interrupt if needed. 

Input: X, Y, A registers—doesn’t matter. 

Output: Carry bit = 0 means mouse caused the 
interrupt; carry bit = 1 means something else caused it. 
This routine updates $077C to show which event 
caused the interrupt (values in Table 9-5). 


Updates screen holes to show current mouse 

X-Y position and button status; clears VBlInt, button 
and movement interrupt bits in the status byte. Doesn't 
reenable interrupts until after retrieving position 
values. 

Output: Carry bit = 0. 


Sets the mouse position to 0, though not necessarily 
within clamping boundaries; leaves button and 
interrupt bits in status byte unchanged. 

Output: Carry bit = 0. 


Sets the mouse coordinates to new values. 

Input: X and Y screen holes contain new X and Y 
positions. 

Output: Carry bit = 0. 


Sets new clamping boundaries (see Table 9-5). Does 
not affect mouse position or update mouse position 
screen holes; use ReadMouse to do that. 

Input: A register = 0 means set new X boundaries; 
A register = 1 means set new Y boundaries. 

Output: Carry bit = 0. 


Sets the internal mouse position to the upper-left 
corner of the clamping window. Does not update mouse 
position screen holes; use ReadMouse to do t hat. 


Sets startup internal values; does not update 
mouse-position screen holes. 
Output: Carry bit = 0. 


Here is a sample sequence of events and calls: 
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1. Four screen holes contain the mouse’s X and Y coordinates, and one 
contains the status of the last mouse movement (Table 9-5). 

2. Call InitMouse. 

3. Inhibit interrupts, set up the boundaries you want, then call 
ClampMouse. 

4. Use PosMouse, HomeMouse, or ClearMouse to position the mouse where 
you want it. 

5. Put the mouse mode (see address $07FC in Table 9-5) that you want to 
use in the accumulator, then call SetMouse. 

6. If you have set one of the interrupt modes, then when an interrupt 
arrives, call ServeMouse to determine the source of the interrupt. 

7. Disable interrupts and call ReadMouse. Retrieve the position values, 
then reenable interrupts. 


Pascal Support 


Table 9-4 lists the locations and values of the I/O firmware protocol that 
Pascal 1.1 and later versions use. However, Pascal must use a special attach 
driver to support the mouse. 


Table 9-4. Mouse Port I/O Firmware Protocol 


Address Value Description 

$0405 $38 Pascal ID byte 

$0407 $18 Pascal ID byte 

$C40B $01 Generic signature byte of firmware cards 

$C40C $20 2 = X-Y pointing device; 0 = identification code 

$C40D Initialization routine (not implemented; returns 
error code) 

$C40E Standard read routine (not implemented; returns 
error code) 

$C40F Standard write routine (not implemented; 
returns error code) 

$0410 Standard status routine (not implemented; 
returns error code) 

$0411 $00 Optional routines follow 

$C4FB $D6 A mouse identification byte 
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important! 


BASIC and Assembly-Language Support 


In BASIC, you must turn the mouse on by printing PR#4 and then CHR$(1) 
before you can get input from the mouse. This sets transparent mode. After 
that, reenable video output with PR#8, and take subsequent input from the 
mouse by issuing IN#4. The first input statement after that (INPUT X,Y,S) 
initializes and enables the mouse, and returns a three-element string 


+XXxx,+yyyy,+st 
representing the x-coordinate, y-coordinate, and status digits. 


The coordinates will be integers between 0 and +1028. These are called the 
clamping boundaries of the mouse. 


The sign preceding the status digits is normally positive; it becormes 
negative when you press a key on the keyboard. 


The first digit, s, of the status is 0. The second digit, t, of the status is 1 if the 
mouse button is still pressed, 2 if it was just pressed, 3 if it was just 
released, and 4 if it is still released. 


To disable the mouse, use these statements: 


PRINT CHRSC4)"PR#4" 
PRINT CHR$C8) 
PRINT CHRC4)°PR#3" 


9.1.5 Screen Holes 
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Table 9-5 lists the screen holes that the mouse firmware uses. Note that the 
mouse firmware reserves port 5 screen holes for its own use. Also, the 
auxiliary page counterparts of the port 4 addresses are reserved for startup 
values. 


Some screen holes are different for the Apple IIe mouse. Refer to 
Appendix F. 


Table 9-5. Mouse Port Screen Hole Locations 


Scratch Area: 

Location Description 

$0478 Low byte of clamping minimum 

$04F8 Low byte of clamping maximum 
$0578 High byte of clamping mimimum 
$05F8 High byte of clamping maximum 
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Table 9-5—continued. Mouse Port Screen Hole Locations 


Port 4 Screen Holes: 
Location Description 
$047C Low byte of X coordinate 
$04FC Low byte of Y coordinate 
$057C High byte of X coordinate 
$05FC High byte of Y coordinate 
$067C Reserved 
$06FC Reserved 
$077C Status byte 
Bit 1 Equals 
fi Button down 
6 Button was down on last read and still down 
5 Movement since last read 
4 Reserved 
3 Interrupt from VBlInt 
2 Interrupt from button 
l Interrupt from movement 
0 Reserved 
$07FC Mode byte (current mode; mask out bits 4-7 when testing) 
Bit 1 Equals 
1-4 Reserved 
3 VBlint active 
2 VBL interrupt on button 
VBL interrupt on movement 
0 Mouse active 
Port 5 Screen Holes: 
Reserved 


9.1.6 Using the Mouse as a Hand Controller 


You can use the mouse as if it were a set of hand controllers or an 

X-Y pointing device in port 4. If you turn the mouse on, the Monitor hand 
controller (game paddle) routines take input from the mouse. This is 
possible because the mouse and the hand controllers all use the same back 
panel connector. 
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You can run a BASIC program that uses the Pdl function to read from the 
mouse by doing the following, either from the keyboard or from @ program: 
. Start up the system with the BASIC program that uses paddles. 
. Type PR#4 and press to turn on the mouse. 


1 

2 

3. Press to initialize the mouse. 

4. Type PR#® and press to restore output to the screen. 
5. RUN the program. 


Play the game using the mouse instead of the paddles. 


Many copy-protected games do not work with a mouse. Also, many games 
don’t use built-in firmware for the paddles. 


9.2 Game Input 
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The Apple IIc supports game paddles, joysticks, and other hand controllers 
connected to the DB-9 connector on its back panel. Table 9-6 is a summary 
of game input characteristics. 


Table 9-6. Game Input Characteristics 


Port number: None 
Commands: None 
Initial 


characteristics: | Game inputs cannot be disabled. 


Hardware page locations: 


$C061 Switch input 0 and (G] 

$C062 Switch input 1 and (@) 

$C063 Mouse button (sense is opposite that of $C061 to distinguish 
it from paddle button) 

$C064 Analog input (paddle) 0 

$C065 Analog input (paddle) 1 

$C070 Trigger paddle timer 
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Complete electrical specifications of these 
inputs are given in Chapter 11; Table 11-22 
shows the connector pin numbers. 


Table 9-6—continued. Game Input Characteristics 


Monitor firmware routines: 
Location Name Description 


$FBIE PRead Reads a paddle position 


1/0 firmware entry points: None 


Use of screen holes: None 


9.2.1 The Hand Controller Connector Signals 
———————————EEE—_——————————————————————————————— SSS 


Several inputs are available to programs or devices from the 9-pin D-type 
miniature connector on the back of the Apple IIc: two 1-bit inputs, or 
switches, and two analog inputs. 


When you connect a pair of hand controllers to the 9-pin connector, the 
rotary controllers use two analog inputs, and the pushbuttons use two 1-bit 
inputs. However, you can also use these inputs for many other jobs. For 
example, two analog inputs can be used with a two-axis joystick. 


Switch Inputs (Sw0 and Sw1) 


The two 1-bit inputs can be connected to the output of another electronic 
device that meets the electrical requirements described in Chapter 11, or to 
a pushbutton. When you read a byte from one of these locations, only the 
high-order bit—bit 7—is valid information; the rest of the byte is undefined. 
From machine language, you can do a Branch Plus or Branch Minus on the 
state of bit 7. From BASIC, you can read the switch with a PEEK and 
compare the value with 128. If the value is 128 or greater, the switch is on. 


The memory locations for these switches are $C061, $C062, and $C063 
(decimal locations 49249 through 49251), as shown in Table 9-6. Switch 0 
and switch 1 are permanently connected to [G) and (#]on the keyboard; 
these are the ones connected to the buttons on the hand controllers. 
Location $C068 is a second address for the mouse button, so that a program 
can distinguish it from an[G] keypress. When the mouse button is pressed, 
$0063 (bit 7) goes from 1 to 0, and $C061 (bit 7) goes from 0 to 1. 
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AWarning 


Analog Inputs (PdlO and Pdl1) 


The two analog inputs are designed for use with 150-KQ variable resistors or 
potentiometers. The variable resistance is connected between the 

+5V supply and each input, so that it makes up part of a timing circuit 
(refer to Section 11.13 for details). The circuit changes state when its time 
constant has elapsed, and the time constant varies as the resistance varies. 
Your program can measure this time by counting in a loop until the circuit 
changes state, or times out. 


A program must first reset the timing circuits before it can read the analog 
inputs. Accessing memory location $C070 does this. As soon as you reset the 
timing circuits, the high bits of the bytes at locations $C064 through $C067 
are set to 1. If you PEEK at them from BASIC (locations 49252 through 
49255), the values will be 128 or greater. Within about three milliseconds, 
these bits will change back to 0—byte values less than 128—and remain 
there until you reset the timing circuits again. The exact amount of time 
each of the bits remains high is directly proportional to the resistance 
connected to the corresponding input. If these inputs are open—no 
resistances are connected—the corresponding bits may remain high 
indefinitely. 


9.2.2 Monitor Support for Game Input 
a ee eee 


To read the analog inputs from machine language, you can use a program 
loop that resets the timers and then increments a counter until the bit at the 
appropriate memory location changes to 0, or you can use the built-in 
routine PRead. BASIC and other high-level languages also include 
convenient means of reading the analog inputs—refer to your language 
manuals. You can read and reread the same paddle at arbitrarily short 
intervals. However, you must wait at least three milliseconds bet ween 
reading one paddle and reading a different paddle. 


The Monitor routine PRead (at address $FB1E) places in the Y register a 
number between $00 and $FF that represents the position of a hand 
controller. You pass the number of the hand controller in the X register. 


If the hand controller number you furnish in the X register does not 
equal 0 or 1, strange things may happen. 


The paddle and vertical blanking both use $C070. Disable interrupts 
before calling PRead if you are reading the paddles and using VBL 
interrupts. 
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The System Monitor is a set of subroutines in the Apple IIc firmware that 
provides a standard interface to the built-in 1/O devices described in 
Chapter 1. Many of the I/O subroutines described in Chapters 3 through 9 
are part of the System Monitor. 


DOS (but not ProDOS) and the BASIC interpreters (Appendix E) use these 
subroutines by direct calls to their starting locations. You can call the 
standard subroutines from your programs in the same fashion. The starting 
addresses for all of the standard subroutines are listed in Appendix C. 


You can perform most of the Monitor functions directly from the keyboard. 
This chapter tells you how to use the Monitor 


O to look at one or more memory locations 
O to change the contents of any location 


oO to write small programs in machine language to be executed directly by 
the Apple IIc 


oO to move and compare blocks of memory 
O to invoke other programs from the Monitor. 


10.1 Invoking the Monitor 


The positive and negative decimal 
equivalents of Monitor locations are listed 
in Appendix C. In addition, Appendix H 
contains conversion tables from one 
numbering system to another. Appendix E 
gives further details on how to use Apple IIc 
firmware from BASIC programs. 
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Important! 


The System Monitor starts at memory location $FF69 (-151). To invoke the 
Monitor, you make a CALL -151 statement to this location from the 
keyboard or from a BASIC program. When the Monitor is running, its 
prompting character, an asterisk (*), appears on the left side of the display 
screen, followed by a cursor. 


To use the Monitor, you type commands at the keyboard. When you have 
finished using the Monitor, you return to the BASIC language you were 
previously using by pressing [CONTROL } RESET ], by pressing 


and then (RETURN ], or by typing 3DaG, which executes the 
resident program—usually Applesoft—whose address is stored in a jump 


instruction at location $03D0. 


If ProDOS (or DOS) is connected via the standard I/O links (Chapter 3), 
then you can issue commands to it from the Monitor. Under this 
arrangement, errors will return control to BASIC rather than to the 
Monitor. 


If you want to have return you to the Monitor, load the 
values $69, $FF, and $5A (decimal 105, 255, and 90) into the three locations 
starting at address $03F2 (decimal 1010, the reset-vector address and the 
power-up byte). 
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10.2 Syntax of Monitor Commands 


To give a command to the Monitor, you type a line on the keyboard, then 
press [RETURN }. The Monitor accepts the line using the standard I/O 
subroutine GetLn described in Chapter 8. A Monitor command can be up to 
250 Characters in length, ending with a carriage return. It can include three 
kinds of information: addresses, data values, and command characters. You 
type addresses and data values in hexadecimal notation. 


When the command you type calls for an address, the Monitor accepts any 
group of hexadecimal digits. If there are fewer than four digits in the group, 
it adds leading Os; if there are more than four hexadecimal digits, the 
Monitor uses only the last four digits. It follows a similar procedure when 
the command syntax calls for two-digit data values. 


Each command you type consists of one command character, usually the 
first letter of the command name. The Monitor recognizes 22 different 
command characters. Some of them are punctuation marks, some are 
letters (uppercase or lowercase), and some are control characters. 


Note: Although the Monitor recognizes and interprets them, control 
characters typed on an input line do not appear on the screen. 


This chapter contains examples of Monitor command use. Some of the data 
values displayed by your Apple IIc may differ from the values printed in 
these examples, because they are variables stored in RAM. 


10.3 Monitor Memory Commands 


When you use the Monitor to examine and change the contents of memory, 
it keeps track of the address of the last location whose value you inquired 

about and the address of the location that is next to have its value changed. 
These are called the last opened location and the next changeable location. 


AWarning Because locations $C000 through $COFF contain special hardware 
circuits, issuing any command that reads or writes on this page can have 
unpredictable, and perhaps disastrous, results. 
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10.3.1 Examining Memory Contents 

aS SS SS a a ee 

When you type the address of a memory location and press [RETURN ], the 
Monitor responds with the address you typed, a dash, a space, an d the value 
stored at that location, like this: 


*EO08 
E®OD- 4C 
“33 
68033- AA 


Each time the Monitor displays the value stored at a location, it saves that 
address as the last opened location and as the next changeable location. 


10.3.2 Memory Dump 
Cee Se eee 


When you type a period (.) followed by an address, and then press 
(RETURN ], the Monitor displays a memory dump: the data values stored at 
all the memory locations from the one following the last opened location to 
the location whose address you typed following the period. The M onitor 
saves the last location displayed as both the last opened location and the 
next changeable location. In these examples, the amount of data Cisplayed 
by the Monitor depends on how much larger the address after the period is 
than the last opened location. 


*28 


8020- 68 
*.2B 


8H21- 28 66 18 OF BC OB BO 
8628- AB B86 DB 67 
#380 


8380- 99 
aires ab | 


6361- BS 66 868 BA BA BA 99 
§9308- 668 68 C8 DO F4 AGB 2B AY 
§8310- 89 8S 27 AD CC 63 

*.32A 
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86316- 85 41 

§8318- 84 48 8A 4A 4A 4A 4A 89 
6320- CO 85 3F AY SD 8S 3E 28 
6328- 43 803 26 


# 


When the Monitor performs a memory dump, it starts at the address 
immediately following the last opened location and displays that address 
and the data value stored there. It then displays the values of successive 
locations up to and including the location whose address you typed, but 
only up to eight values on a line. When it reaches a location whose address 
is a multiple of 8—that is, one that ends with an 8 or a 0—it displays that 
address as the beginning of a new line, then continues displaying more 
values. 


After the Monitor has displayed the value at the location whose address you 
specified in the command, it stops the memory dump and sets that location 
as both the last opened location and the next changeable location. If the 
address specified on the input line is less than the address of the last 
opened location, the Monitor displays only the address and value of the 
location following the last opened location. 


You can combine the two commands, opening a location and dumping 
memory, by concatenating them: type the first address, a period, and the 
second address. This combination of two addresses separated by a period is 
called a memory range. 


*300.32F 


6306- 99 BS 68 88 BA BA BA 99 
6308- 668 68 C8 DO F4 AG 2B AY 
6316- 69 85 27 AD CC 83 85 41 
6318- 84 48 BA 4A 4A 4A 4A 89 
6328- C8 8S 3F AS SD 85 3E 20 
6328- 43 63 28 46 83 AS 3D 4D 
*30.48 


8O9368- AA 68 FF AA 65 C2 6S C2 
§8638- 1B FD D# 83 3C BB 46 68 
8648- 36 

*E915.E025 


E@1S5- 4C ED FD 
E918- AY 20 CS 24 BB BC AD BD 
E@20- AB 87 26 ED FD AY 


# 
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AWarning 


Pressing by itself makes the Monitor display one line of a memory 
dump; that is, a memory dump from the location following the last opened 
location to the next multiple-of-8 boundary. The Monitor saves t_he address 
of the last location displayed as both the last opened location and the next 
changeable location. 


75 

8085- 68 
*| RETURN 
66 08 

*| RETURN 


8088- 66 66 69 66 68 B66 BO BB 
*32 


9032- FF 
*[RETURN } 


AA 88 C2 B85 C2 
*[RETURN ] 


§8038- 1B FD D® 83 3C 6H 3F O86 


# 


10.3.3 Changing Memory Contents 
hi SS ae eee eS er 


Section 10.3.2 showed you how to dzsplay values stored in the Apple IIc’s 
memory; this section shows you how to change these values. You can 
change any location in RAM; you can change the characteristics and 
treatment of an output device by changing the contents of locations 
assigned to it; and you can change a soft switch setting by referemcing its 
set and reset addresses. 


Use these commands carefully. If you change the zero-page loc ations 
used by the interpreter or operating system (Appendix B), you may lose 
programs or data stored in memory. 


Changing One Byte 


The previous commands keep track of the next changeable location; these 
commands make use of it. In the next example, you open location 0, then 
type a colon followed by a value. 


*9 
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B800- 4C 
*sor 


The contents of the next changeable location have just been changed to the 
value you typed, as you can see by examining that location: 

*6 

O600- SF 


# 


You can also combine opening and changing into one operation by typing an 
address followed by a colon and a value. In the example, you type the 
address again to verify the change. 


*302:42 
*302 
8302- 42 


# 


When you change the contents of a location, the value that was contained 
in that location is replaced by the new value, which will remain until you or 
some program replaces it with another value. 


ASCII Input Mode: The Monitor has a tool to make entering values a 
little easier: ASCII input mode. ASCII input mode lets you enter ASCII 
characters as well as their hexadecimal ASCII equivalents. This means 
that ’ A is the same as Cl and “Bis the same as C2 to the Monitor. The 
ASCII value for any character following an apostrophe is used by the 
Monitor. For example, to enter the string “Good morning!” at $0300 in 
memory, type 


#300:°G ‘0 ’‘o0 ‘d % ‘m ’o “r “n “i “nn ‘g ‘t 


Note that each character to be placed in memory is delimited by a leading 
and a trailing space. The only exception to this rule is that the last 
character in the line is followed by a RETURN character instead of a 
space. 


Changing Consecutive Locations 


You don’t have to type a separate command with an address, a colon, a 
value, and press for each location you want to change. You can 
change the values of up to 85 consecutive locations at a time—or even 
more, if you omit leading 0s from the values—by typing only the initial 
address and colon followed by all the values separated by spaces; end with 
(RETURN }. The Monitor stores the consecutive values in consecutive 
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locations, starting at the location whose address you typed. After it has 
processed the string of values, it takes the location following the last 
changed location as the next changeable location. Thus, you cam continue 
changing consecutive locations, without typing an address on the next 
input line, by typing another colon and more values. In these examples, you 
first change some locations, then examine them to verify the ch.anges. 


*308:69 61 26 ED FD 4C 63 
#308 


§8380- 69 
*| RETURN 


61 20 ED FD 4C 88 63 
*160:8 12 3 


req 3G 7 
*18.17 


0018- 68 81 B82 B63 64 OS 86 B7 


# 


10.3.4 Moving Data in Memory 


You can copy a contiguous block of data from one area in the Apple IIc’s 
memory to another in RAM by using the Monitor’s MOVE command. To 
move a range of memory, you must tell the Monitor both where t-he data is 
now situated in memory—the source locations—and where you want the 
copy to go—the destination locations. 


The format of the complete MOVE command looks like this: 
(destination) < {start} . |end} (M1) 


The destination is the address where you want the first of the moved data 
to go. The less-than symbol (<) separates the destination address from the 
starting and ending addresses of the block of data to be moved. The period 
between two addresses is the Monitor’s standard notation for specifying 
address ranges. If the second address in the source range specification is 
less than the first, then only one value (that of the first location in the 
range) will be moved. 
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See Section 10.6 for an interesting 
application of this feature. 


When you type the actual command, replace the words in braces with 
hexadecimal addresses, and omit the braces and spaces. Here are some 
examples of memory moves. First, you examine the values stored in one 
range of memory, then store several values in another range of memory. 
The actual MOVE commands end with (™}. 


"OF 


8O80- SF 68 65 O87 88 66 68 BB 
80898- 606 608 08 BB BB 86 88 8B 
*380:A9 8D 26 ED FD AS 45 26 DA FD 4C 68 83 


*3080.36C 


0300- AO 8D 26 ED FD AQ 45 28 
0308- DA FD 4C 08 83 
*9<308.30C([M|] 


*§.C 


6608- AO 8D 28 ED FD AS 45 26 
0608- DA FD 4C 68 43 
*318<8.A[M] 


*#319.312 
8310- DA FD 4C 


*2<7.9(M] 


*§.C 


869808- AB 8D 26 DA FD AY 45 28 
B6888- DA FD 4C 868 63 


# 


The Monitor moves a copy of the data stored in the source range of locations 
to the destination locations. The values in the source range are left 
undisturbed. The Monitor remembers the last location in the source range 
as the last opened location, and the first location in the source range as the 
next changeable location. 


If the destination address of the MOVE command is inside the source range 
of addresses, then strange things happen: the locations between the 
beginning of the source range and the destination address are treated as a 
subrange and the values in this subrange are replicated throughout the 
source range. Try it. 


10.3 Monitor Memory Commands 195 


196 


10.3.5 Comparing Data in Memory 
—SSE—E— SSS SSS SSS aa ee 


You can use the VERIFY command to compare two ranges of memory using 
the same format you use to move a range of memory from one place to 
another. In fact, the VERIFY command can be used immediately after a 
MOVE to make sure that the move was successful. 


The VERIFY command, like the MOVE command, needs a range and a 
destination. The syntax of the VERIFY command is 


\destination| < |start} . jend| 


The Monitor compares the values in the source locations with t he values in 
the locations beginning at the destination address. If any values don’t 
match, the Monitor displays the address at which the discrepancy was 
found and the two values that differ. In the example, you store data values 
in the range of locations from 0 to $0D, copy them to locations s tarting 

at $0300 with the MOVE command, and then compare them using the 
VERIFY command. When you use the VERIFY command after you change 
the value at location 6 to $E4, it detects the change. 


*9:D7 F2 E9 F4 F4 ES EE AB E2 F9 AB C3 C4 CS 
*300<0.D(M] 

*306<0.D(Vv] 

*6:E4 

*300<8.D(V] 

9006-E4 (EE) 


# 


If the VERIFY command finds a discrepancy, it displays the address of the 
location in the source range whose value differs from its counterpart in the 
destination range. If there is no discrepancy, VERIFY displays nothing. The 
VERIFY command leaves the values in both ranges unchanged. The last 
opened location is the last location in the source range, and the mext 
changeable location is the first location in the source range, just as in the 
MOVE command. If the ending address of the range is less than the starting 
address, the values of only the first locations in the ranges are compared. 
Like the MOVE command, the VERIFY command does unusual things if the 
destination address is within the source range; see Section 10.6. 
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10.4 Monitor Register Commands 


Even though the actual contents of the 65C02’s internal registers are 
changing as you use the Monitor, you can examine the values that the 
registers contained at the time the Monitor gained control, either because 
you called it or because the program you are debugging stopped at a 

break (BRK). You can also store new register values that will be used when 
you execute a program from the Monitor using the GO command, described 
below. 


10.4.1 Changing Registers 
_———————— a ee eee tet CaP ee] 


When you call the Monitor, it stores the contents of the 65C02 registers in 
memory. The registers are stored in the order A, X, Y, P (processor status 
register), and S (stack pointer), starting at location $45. When you give the 
Monitor a GO command, the Monitor loads the registers from these five 
locations before it executes the first instruction in your program. 


10.4.2 Examining Registers 
a ee a ee 


Pressing and then invokes the Monitor’s EXAMINE 
command, which displays the stored register values and sets the location 
containing the contents of the A register as the next changeable location. 
After using the EXAMINE command, you can change the values in these 
locations by typing a colon and then typing the new values separated by 
spaces. In the following example, you display the registers, change the first 
two, and then display them again to verify the change. 


*(CONTROL }{E] 

M=98 A=GA X=FF Y=D8 P=BO S=F8 
*:BO 02 

*| CONTROL }/E | 

M=98 A=B@ X=62 Y=D8 P=BO S=F8 


# 


In the EXAMINE command’s display, M shows the current memory state 
register contents. The memory state register is location $44, and its 
interpretation is given in Section E.4 of Appendix E. 
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10.5 Miscellaneous Monitor Commands 


The COut subroutine is described in 


Chapter 3. 


See Appendix D. 
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Important! 


Monitor commands discussed in this section let you do the following: 


o change the video display format from normal to inverse and back 
O assign input and output to various devices 


O leave the Monitor and return to the currently-loaded operatin g system 
(DOS 3.3 or ProDOS) or BASIC 


10.5.1 Display Inverse and Normal 


as ee i eS ae 

You can control the setting of the inverse-normal mask location used by the 
COut subroutine from the Monitor so that all the Monitor’s output will be in 
inverse format. The INVERSE command (I) sets the mask so that all 
subsequent inputs and outputs are displayed in inverse format. “To switch 
the Monitor’s output back to normal format, use the NORMAL 

command (N). 


*0.F 


6608- BA 6B OC OD BE OF DO B4 
6608- C6 61 FB 68 CA DO FE AG 


6808- BA 6B OC BD OE BF DB 84 
8808- C6 61 FH 88 CA DB FE AG 


6608- BA 6B OBC OD BE BOF DB 84 
6608- C6 61 FH 68 CA DB FE AG 


10.5.2 Back to BASIC 


= as | 
If you are using one of the Apple disk operating systems (ProDOS or DOS), 


press or type 3D4G to return to the language you were 
using, with your program and variables intact. 


If you type the latter command, make sure that the third chara cter you 
type is a zero, not a letter O. The letter G is the Monitor’s GO command, 
described in Section 10.7. 
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If there is no operating system in RAM, use the BASIC command 
CONTROL-B to leave the Monitor and enter the BASIC interpreter that was 
active when you entered the Monitor. (Normally this is Applesoft BASIC.) 
Any program or variables that you had previously in BASIC will be lost. If 
you want to reenter BASIC with your previous program and variables 
intact, use the CONTINUE BASIC command (CONTROL-C). 


10.5.3 Redirecting Input and Output 
em eg ae eg ee ee | 


The CONTROL-P command diverts all output normally destined for the 
screen (port 0) to a device attached to one of the other ports, from 1 to 7. 
The format of the command is 

Chapter 3 lists the Ap ple IIc port numbers {port number} CONTROL-P 


available. 
A CONTROL-P command to port number 0 switches the stream of output 


characters back to the Apple IIc’s video display. However, use ESC 
CONTROL-Q if the enhanced video firmware is active (solid-block cursor). 


CONTROL-K controls the input stream in much the same way as 
CONTROL-P controls the output stream. The format for the command is 


‘port number! CONTROL-K 


Pressing (0] directs the Monitor to accept input from the 
Apple IIc’s built-in keyboard. 


For more information on the way those The CONTROL-P and CONTROL-K commands are the exact equivalents of 
commands work, refer to Section 3.1. the BASIC (but not DOS and ProDOS) commands PR# and IN#. 


10.5.4 Hexadecimal Arithmetic 


You can use the Monitor as a one-byte hexadecimal addition and subtraction 
calculator. Just type a line in one of these formats followed by [RETURN]: 


pave + |value} (RETURN 
ivalue} — |value} [RETURN 


The Apple IIc performs the arithmetic and displays the result, as shown in 
these examples. 


*28+13 
#33 
*4A-C 
=3E 


# 
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10.6 Advanced Operations 
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This section describes some ways of using the Monitor commands to speed 
up your work. 


10.6.1 Multiple-Command Lines 
Sn ee ee ee ee 2s) 


You can put as many Monitor commands on a single line as you Like, as long 
as you separate them with spaces, and the total number of characters in the 
line is less than 254. Adjacent single-letter commands such as L, S, I, and N 
need not be separated by spaces. 


You can freely intermix all of the commands except the STORE (:) 
command. Since the Monitor takes all values following a colon amd places 
them in consecutive memory locations, the last value in a STORE must be 
followed by a letter command before another address is encountered. You 
can use the NORMAL command as the required letter command in such 
cases; it usually has no effect and can be used anywhere. 


In the following example, you display a range of memory, change it, and 
display it again, all with one line of commands. 


*300.3807 306:18 69 1(N]308.362 


83080- 60 68 66 66 08 88 6B 88 
6366- 18 69 61 


# 


If the Monitor encounters a character in the input line that it does not 
recognize as either a hexadecimal digit or a valid command character, it 
executes all the commands on the input line up to that character, then stops 
with a beep and ignores the remainder of the input line. 


10.6.2 Filling Memory 


a ae ee ee eee 

The MOVE command can be used to replicate a pattern of values 
throughout a range of memory. To do this, first store the pattern :in the first 
locations in the range: 


*360:11 22 33 


# 


Remember the number of values in the pattern: in this case, it is three. Use 
the number to compute addresses for the MOVE command, like this: 
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istart+number, < start) . jend-number} (iM) 


This MOVE command first replicates the pattern at the locations 
immediately following the original pattern, then replicates that pattern 
following itself, and so on until it fills the entire range. 


*303<308.32D(M] 
*300.32F 


8308- 11 22 33 11 22 33 11 22 
8308- 33 11 22 33 11 22 33 11 
89319- 22 33 11 22 33 11 22 33 
§6318- 11 22 33 11 22 33 11 22 
§9328- 33 11 22 33 11 22 33 11 
8328- 22 33 11 22 33 11 22 33 


# 


You can use the VERIFY command to check whether a pattern repeats itself 
through memory. This is especially useful to verify that a given range of 
memory locations all contain the same value. In this example, to see the 
VERIFY command detect the discrepancy, you first fill the memory range 
from $0300 to $0320 with 0s and verify it, then change one location and 
verify again: 


*300:0 
*391<300.31F([M] 
*301<300.31F(V] 
*304:02 
*301<300.31F [Vv] 


68303-6086 C82) 
8304-82 C88) 


Si 


10.6.3 Repeating Commands 


Sean ee eee 

You can create a command line that repeats one or more commands over 
and over. You do this by beginning the part of the command line that you 
want to repeat with a letter command, such as N, and ending it with the 
sequence 34:n, where n is a hexadecimal number that specifies the position 
in the line of the command where you want to start repeating: for the first 
character in the line, n=0. The value for n must be followed with a space in 
order for the loop to work properly. 
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This trick takes advantage of the fact that the Monitor uses an index 
register to step through the input buffer, starting at location $0200. Each 
time the Monitor executes a command, it stores the value of the index at 
location $34; when that command is finished, the Monitor reloads the index 
register with the value at location $34. By making the last command change 
the value at location $34, you change this index so that the Monitor picks up 
the next command character from an earlier point in the buffer. 


The only way to stop a loop like this 1s to press [CONTROL }{ RESET }; that is 
how this example ends. 


*(N]}388 362 34:90(N] 


O306- 11 
8302- 33 
O8306- 11 
8382- 33 
OB388- 11 
8302- 33 
B306- 11 
8302- 33 
O6308- 11 
8382- 33 
O8300- 11 
8302- 33 
638 


# 


10.6.4 Creating Your Own Commands 


eg RN Se) 

The USER command (CONTROL-Y) forces the Monitor to jump to memory 
location $03F8. You can put a JMP instruction there that jumps to your own 
machine-language program. Your program can then examine the Monitor's 
registers and pointers or the input buffer itself to obtain its data. For 
example, here is a program that displays everything on the input Line after 
the CONTROL-Y. The program starts at location $0300; the command line 
that starts with $03F8 stores a jump to $0300 at location $03F8. 


*308:A4 34 BI O06 G82 20 ED FD C8 C9 8D DO FS 4C 69 FF 


*3F8:4C 66 83 


*| CONTROL} Y|THIS IS A TEST 
THIS IS A TEST 


# 
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10.7 Machine-Language Programs 

5°99 Eg eis ae er esse 
The main reason to program in machine language is to get more speed and 
sometimes to also save memory space. A program in machine language can 
run much faster than the same program written in high-level languages 
such as BASIC or Pascal, but the machine-language version usually takes a 
lot longer to write. There are other reasons to use machine language: you 
might want your program to do something that isn’t included in your 
high-level language, or you might just enjoy the challenge of using machine 
language to work directly on the bits and bytes. 


Note: If you have never used machine language before, you'll need to 
learn the 65C02 instructions listed in Appendix A. To become proficient 
at programming in machine language, you'll have to spend some time at 
it, and study one of the books on 65C02 programming listed in the 
bibliography. 


You can get a hexadecimal dump of your program or move it around in 
memory using the commands described in the previous sections. The 
Monitor commands in this section are intended specifically for you to use in 
creating, writing, and debugging machine-language programs. 


10.7.1 Running a Program 
Se oe ee eee 


The Monitor command to start execution of your machine-language 
program is the GO command. When you type an address and press (G], the 
Apple IIc starts executing machine-language instructions starting at the 
specified location. If you just press (G], execution starts at the last opened 
location. The Monitor treats this program as a subroutine: it should end with 
an RTS (return from subroutine) instruction to transfer control back to the 
Monitor. 


The Monitor has some special features that make it easier for you to write 
and debug machine-language programs, but before you get into that, here is 
a small machine-language program that you can run using only the simple 
Monitor commands already described. The program in the example merely 
displays the letters A through Z: you store it starting at location $0300, 
examine it to be sure you typed it correctly, then type 3896 to start it 
running. 


*360:A9 C1 260 ED FD 18 69 1 C9 DB D8 FE 6B 


*360.30C 
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8380- AY C1 260 ED FD 18 69 61 
6308- C9 DB D#@ FE 6B 


*360(G| 


ABCDEFGHI JKLMNOPQRSTUVWXYZ 


# 


10.7.2 Disassembled Programs 


Saar ar ae 

Machine-language code in hexadecimal isn’t the easiest thing in the world 
to read and understand. To make this job a little easier, machine-language 
programs are usually written in assembly language and converted into 
machine-language code by programs called assemblers. 


Programs like the Monitor’s LIST command are called disassemb ers. This 
command displays machine-language code in assembly-language form. 
Instead of unformatted hexadecimal gibberish, the LIST command displays 
each instruction on a separate line, with a three-letter instruction name, or 
mnemonic, and a formatted hexadecimal operand. The LIST command also 
converts the relative addresses used in branch instructions to absolute 
addresses. 


The Monitor LIST command has the format 
location; 


The LIST command starts at the specified location and displays as much 
memory as it takes to make up a screenful (20 lines) of instructions, as 
shown in the following example: 


*300(L] 

8300- AQ C1 LDA #$C1 
8302- 20 ED FD JSR $FDED 
9305- 18 CLC 

9306- 69 81 ADC #$01 
9308- C9 DB CMP #$DB 
830A- D@ FG BNE $9302 
930C- 68 RTS 

830D- 80 BRK 

B30E- 88 BRK 

030F - 80 BRK 

6310- 80 BRK 

6311- 80 BRK 
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8312- 00 BRK 


6313- 86 BRK 
§6314- 66 BRK 
§6315- 68 BRK 
§316- 60 BRK 
6317- 06 BRK 
§318- 68 BRK 
§319- 66 BRK 


# 


The first seven lines of this example are the assembly-language form of the 
program you typed in the previous example. The rest of the lines are BRK 
instructions only if this part of memory has Os in it: other values will be 
disassembled as other instructions. 


The Monitor saves the address that you specify in the LIST command, but 
not as the last opened location used by the other commands. Instead, the 
Monitor saves this address as the program counter, which it uses only to 
point to locations within programs. Whenever the Monitor performs a LIST 
command, it sets the program counter to point to the location immediately 
following the last location displayed on the screen, so that if you type 
another LIST command it displays another screenful of instructions, 
starting where the previous display left off. 


10.8 The STEP and TRACE Commands 


UniDisk 3.5 Section 10.8 applies only to the version of the Apple IIc that supports 
UniDisk 3.5. 


STEP and TRACE are Monitor facilities for debugging assembly-language 
programs. The STEP command decodes, displays, and executes one 
instruction at a time, and the TRACE command steps continuously through 
a program, stopping when a BRK instruction is executed or (#)is pressed. 
You can press [G] to slow down the trace to one step per second. 


Each STEP command causes the Monitor to execute the instruction in 
memory pointed to by the program counter. The instruction is displayed in 
its disassembled form, then executed. The contents of the 65C02’s internal 
registers are displayed after the instruction is executed. After execution, the 
program counter is incremented to point to the next instruction in the 
program. 
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Here is an example of the STEP command, using the following program: 


$0308: LDX #62 
$0302: LDA $86,X 
$0304: STA $10,X 
$0306: DEX 
$0307: STA $C838 
SO30A: BPL $9362 
$030C: BRK 


To step through this program, first call the Monitor by typing CALL-151 
and pressing [RETURN ], and then from the Monitor, type 3@@S (to start the 
STEP routine at address $0300). Type s to advance each additional step 
through the program. The Monitor keeps the program counter and the last 
opened address separate from one another, so you can examine or change 
the contents of memory while you are stepping through your program. 


Here’s what happens when you step through the program above, examining 
the contents of location $0012 after the third step. Note that in this 
example, what you type appears just after the * prompt, and the 
information on the next two lines—that begin without the * prompt—is 
what the computer displays on the screen in response. 


*360S 

6386 - A2 62 LDX #82 

M=CA A=B8A X=82 Y=D8 P=38 S=F8 
=S 

§382- BS 686 LDA $68,X 
M=CA A=8C X=82 Y=D8 P=30 S=F8 
3 

6364- 95 18 STA $18,X 
M=CA A=8C X#*B82 Y=D8 P=30 S=F8 
#12 

86812- BC 

“S 

6306- CA DE X 

M=CA A=8C X=81 Y=D8 P=30 S=F8 
=o 


§367- 8D 30 CO STA $C838 
M=CA A=6C X=81 Y=D8 P=38 S=F8 
*S 
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B36A- 18 FG BPL $8382 
M=CA A=8C X=81 Y=D8 P=308 S=F8 


*> 

§362- BS 08 LDA $66,X 
M=CA A=8B X=01 Y=D8 P=30 S=F8 
7S 

6364- 95 10 STA $10,X 


M=CA A=68B X=081 Y=D8 P=38 S=F8 


The TRACE command is a continuous version of the STEP commana; it 
stops stepping through the program only when you press (#], or when it 
encounters a BRK instruction in the program. Press (G) to slow the trace to 
one step per second. 


important! Keep the following cautions in mind when using the STEP and TRACE 
Monitor commands: 


oO Ifthe program ends with an RTS instruction, the TRACE routine will 
continue to run indefinitely until stopped with (6). 


oO You can’t step or trace through routines that use the same zero page 
locations as the Monitor. 


10.9 The Mini-Assembler 


UniDisk 3.5 Section 10.9 applies only to the version of the Apple IIc that supports 
UniDisk 3.5. 


Without an assembler, you have to write your machine-language program, 
take the hexadecimal values for the opcodes and operands, and store them 
in memory using the Monitor commands described in Sections 10.1 through 
10.6 in this chapter. 


The Mini-Assembler lets you enter machine-language programs directly 
from the keyboard of your Apple. ASCII characters can be entered in 
Mini-Assembler programs, exactly as you enter them in the Monitor. 


Note that the Mini-Assembler doesn’t accept labels; you must use actual 
values and addresses. 


10.9 The Mini-Assembler 207 


208 


10.9.1 Starting the Mini-Assembier 


To start the Mini-Assembler, first invoke the Monitor by typing CALL-151 


(RETURN }, and then from the Monitor, type ! followed by [RETURN]. The 
Monitor prompt character then changes from * to !. 


When you finish using the Mini-Assembler, press from a blank 
line to return to the Monitor. 


To enter code into memory, type the address, a colon, and the instruction. 
For example, after entering the Mini-Assembler, you could type: 


'300:STA C8386 


You can enter a series of instructions by typing a space, followedl by the 
instruction, followed by [RETURN }: 


'300:STA CO38 
! LDA #AO 
! INX 


Each succeeding instruction is placed in the next available memery 
location. As you type in instructions, each is replaced by the starting 
address of the instruction, the hexadecimal value(s) of the instruction, 
followed by mnemonics describing the instruction. For example, the 
sequence of instructions given above would produce the followimg on your 
screen: 


§3606- 8D 36 CA STA $C8386 
§363- AS AB LDA #$A8 
6365- E8 INX 


When you're ready to execute your program, press to leave the 
Mini-Assembler and return to the Monitor. Monitor commands can’t be 
executed directly from the Mini-Assembler. 


10.9.2 Using the Mini-Assembler 


SSS——S—S———————————————— ES See 

The Mini-Assembler saves one address, that of the program counter. Before 
you Start to type a program, you must set the program counter to point to 
the location where you want the Mini-Assembler to store your program. Do 
this by typing the address followed by a colon. 
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After the colon, type the mnemonic for the first instruction in your program, 
followed by a space and the operand of the instruction. Now press 
(RETURN }. The Mini-Assembler converts the line you typed into 
hexadecimal, stores it in memory beginning at the location of the program 
counter, and then disassembles it again and displays the disassembled line. 
It then displays a prompt on the next line. 


Now the Mini-Assembler is ready to accept the second instruction in your 
program. To tell it that you want the next instruction to follow the first, 
don’t type an address or a colon: just type a space and the next instruction’s 
mnemonic and operand, then press [RETURN]. The Mini-Assembler 
assembles that line and waits for another. 


If the line you type has an error in it, the Mini-Assembler beeps loudly and 
displays a caret ( * ) under or near the offending character in the input line. 
Most common errors are the result of typographical mistakes: misspelled 
mnemonics, missing parentheses, and so forth. The Mini-Assembler also 
rejects the input line if you forget the space before or after a mnemonic or 
include an extraneous character in a hexadecimal value or address. If the 
destination address of a branch instruction is out of the range of the branch 
(more than 127 locations distant from the address of the instruction), the 
Mini-Assembler flags this as an error. 


Dollar Signs: \n this manual, dollar signs ($) in addresses signify that 
the addresses are in hexadecimal notation. The dollar signs are ignored 
by the Mini-Assembler and can be omitted in programs. 


'300:LDX #682 

8366 - A2 62 LDX #$62 
' LDA $66,X 

8302- BS 68 LDA $60 ,X 
' STA $10,X 

6364 95 18 STA $10,X 
' DEX 

§306- CA DE X 

' STA $C86386 

§387- 8D 38 CB STA $0936 
' BPL $8362 

830A- 10 FG BPL $6362 
! BRK 

830C- 606 BRK 
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To leave the Mini-Assembler and reenter the Monitor, press at a 
blank line. 


Your assembly-language program is now stored in memory. You can display 
it with the LIST command: 


*306L 

8300- A2 Be LDX #$02 
9362- BS 68 LDA $60 ,X 
6364- 95 18 STA $18,X 
68386- CA DE X 

§9387- 8D 38 C8 STA $C 038 
O38A- 10 FE BPL $6362 
O838C- 868 BRK 

B38D- 68 BRK 

B3BE- 08 BRK 

O30F- 60 BRK 

8318- 68 BRK 

O8311- 66 BRK 

O6312- 66 BRK 

8313- 60 BRK 

8314- 68 BRK 

8316- 66 BRK 

68316- 68 BRK 

6317- 68 BRK 

8318- 68 BRK 

6319- 60 BRK 


# 


10.9.3 Mini-Assembler Instruction Formats 


a = a es ee Se ee eS 

The Apple IIc Mini-Assembler recognizes 66 mnemonics and 15 addressing 
formats. The mnemonics are standard, as used in the Synertek 
Programming Manual (Apple part number A2L0003), but the addressing 
formats are somewhat different, as shown in Table 10-1. 


An address consists of one or more hexadecimal digits. The Mini- Assembler 
interprets addresses the same way the Monitor does: if an address has fewer 
than four digits, the Mini-Assembler adds leading 0s; if the address has more 
than four digits, then it uses only the last four. 
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Table 10-1. Mini-Assembler Address Formats 


Addressing Mode Format 
Accumulator 7 
Implied i 
Immediate #${value} 
Absolute ${address} 
Zero page ${address} 
Indexed zero page $/address},X 
Seaaet 
Indexed absolute $/address},X 
seddreestt 
Relative ${address} 
Indexed indirect (${address},X) 
Indirect indexed (${address}),Y 
Absolute indirect (${address}) 


* These instructions have no operands. 


There is no syntactical distinction between the absolute and zero-page 
addressing modes. If you give an instruction to the Mini-Assembler that can 
be used in both absolute and zero-page mode, the Mini-Assembler assembles 
that instruction in absolute mode if the operand for that instruction is 
greater than $FF, and it assembles it in zero-page mode if the operand is less 
than $0100. 


Instructions in accumulator mode and implied addressing mode need no 
operands. 


Branch instructions, which use the relative addressing mode, require the 
target address of the branch. The Mini-Assembler calculates the relative 
distance to use in the instruction automatically. If the target address is more 
than 127 locations distant from the instruction, the Mini-Assembler sounds 
a bell (beep), displays a caret ( * ) under the target address, and does not 
assemble the line. 


If you give the Mini-Assembler the mnemonic for an instruction and an 
operand, and the addressing mode of the operand cannot be used with the 
instruction you entered, then the Mini-Assembler will not accept the line. 
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10.10 Summary of Monitor Commands 


Here is a summary of the Monitor commands, showing the syntax diagram 


for each one. 


10.10.1 Examining Memory 


aa SSS Sa 
jadrs} [RETURN 


jadrs1}.jadrs2| 


jadrs|(c)] 


Displays the value contained in one 
location. 


Displays the values contained in all 
locations between |adrs1 | and 
jadrs2}. 


Displays the values in up to eight 
locations following the last opened 
location. 


Lists disassembled code starting at 
jadrs} and continuing until the 
screen is full. 


10.10.2 Changing the Contents of Memory 


jadrs|:;val| {val}... 


:{vall |vall... 
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STORE command. Stores the values 
in consecutive memory locations 
starting at |adrs|. 


Stores values in memory starting at 
the next changeable location. 


10.10.3 Moving and Comparing 


dest! <!start}./end'[m] 
j > |SUArLy.,eNG 


dest! <{start!./end'[v] 
| ON 


MOVE command. Copies the values 
in the range |start}./end| into the 
range beginning at |dest). 


VERIFY command. Compares the 
values in the range |start}.|end) to 
those in the range beginning at 
\dest}. 


10.10.4 The Register Command 


CONTROL H E| 


EXAMINE command. Displays the 
locations where the contents of the 
65C02’s registers are stored and 
opens them for changing. 


10.10.5 Miscellaneous Monitor Commands 


Zz] 


CONTROL }/B | 


CONTROL 


val +{val! 


\val! — |val]| 


10.10 Summary of Monitor Commands 


INVERSE command. Sets inverse 
display mode. 


NORMAL command. Sets normal 
display mode. 


BASIC command. Enters the 
language currently active (normally 
Applesoft). 


CONTINUE BASIC command. 
Returns to the language currently 
active (normally Applesoft). 


Adds the two values and prints the 
hexadecimal result. 


Subtracts the second value from the 
first and prints the result. 
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port; (P Redirects output to the device 
connected to port number |port)}. If 
port! =0, sends output to the video 
display. Use only when the 
enhanced video firmware is not 
active (checkerboard cursor). 


Feu Redirects output to video display 
when enhanced video firmware is 


active (solid block cursor). 


{port} Takes input from the device 
connected to port number {port}. If 


iport}=0, accepts input from the 


keyboard. 

USER command. Jumps to the 
machine-language subroutine at 
location $03F8. 


10.10.6 Running and Listing Programs 
2 Sa et ne eee ee ees 


jadrs|{G} Transfers control to the machine 
language program beginning at 
ladrs}. 

jadrs}(t] Disassembles and displays 


20 instructions starting at jadrs}. 
Subsequent (L]'s display 20 more 
instructions each. 
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Chapter 11 Hardware Implementation 
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Most of this manual describes functions—what the Apple IIc does. This 
chapter, on the other hand, describes objects: the pieces of hardware the 
Apple IIc uses to carry out its functions. If you are designing a device to 
connect to the Apple IIc back panel, or if you just want to know more about 
how the Apple IIc is built, you should study this chapter. 


11.1 Environmental Specifications 


a a eT PSY Se ea eae 
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The Apple IIc is quite sturdy when used in the way it was intended—as a 
transportable computer, made for use in an indoor environment. You can 
carry it by its handle from room to room, but for longer trips you should use 
its carrying case or some other protective container (such as an attache 
case). 


Table 11-1 defines the conditions under which the Apple IIc is designed to 
function properly. 


Table 11-1. Environmental Specifications 


Operating temperature: 10° to 40° C (50° to 104° F) 
Relative humidity: 20% to 95% 
Line voltage: 105 to 129 VAC (normal USA voltage range) 


You should treat the Apple IIc with the same kind of care as any other 
electrical appliance; protect it from physical abuse, and be careful not to 
bump it against furniture when you move it around. Put it in an attache 
case or other protective covering if you carry it outside. You showld also 
protect the mechanical keyboard and the electrical connectors inside the 
case from spilled liquids, particularly those with dissolved contarninants, 
such as soups, fruit juices, and carbonated soft drinks. 


In normal operation (with the handle locked in its down position), enough 
air flows through the openings in the case to keep the insides frorn getting 
too hot. If you do overheat your Apple IIlc—for example, by block ing the 
upper or lower ventilation openings—the first symptom will be erratic 
operation, such as unexpectedly changed data. (The memory devices in the 
Apple IIc are especially sensitive to heat.) Letting the machine cool down by 
turning it off for a while and unblocking the vents before using it again will 
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bring it back to normal operation. The only exception to this is if you have 
gotten your Apple IIc too hot and physically damaged some internal 
component. 


Disks are another heat-sensitive element of the system. If the built-in drive 
becomes too hot, a disk within can warp or even melt. A melted or warped 
disk can’t be used again. 


11.2 Power Requirements 


a ae 


AWarning 


The electrical power used by the Apple IIc—and everything that draws 
power from it—is limited by the capacities of the computer’s power supply 
and internal voltage converter. This section describes these limits for the 
USA external power supply. Appendix G describes them for models built for 
other countries. The internal voltage converter is the same on all models. 


11.2.1 The External Power Supply 


If you purchased your Apple IIc outside the USA, consult Appendix G for 
external power supply characteristics. 


The external power supply operates on normal household AC power and 
provides DC power to the Apple IIc internal converter. The basic 
specifications of the external power supply are listed in Table 11-2. The 
Apple IIc external power supply’s cord must be plugged into a three-wire 
115-volt (nominal) outlet. A two-wire outlet is not properly grounded— 
using it will damage the external power supply and perhaps the Apple IIc as 
well. The line voltage must be in the range given in Table 11-2. 


Important Safety Instructions: This product is equipped with a 
three-wire grounding-type plug—a plug having a third (grounding) pin. 
This plug will only fit into a grounding-type AC outlet. This is a safety 
feature. 


If you are unable to insert the plug into the outlet, contact a licensed 
electrician to replace the outlet and, if necessary, install a grounding 
conductor. 


Do not defeat the purpose of the grounding-type plug. 
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Table 11-2. Power Supply Specifications 


Line voltage: 105 to 129 VAC, 60 Hz 
Maximum input power 

consumption: 25 W 

Supply voltage: +15 VDC (nominal) 
Supply current: 1.2 A (nominal) 


11.2.2 The External Power Connector 


The external power supply is attached to the internal converter by means of 
a 7-pin DIN connector. The connector pins are identified in Figure 11-1 and 
Table 11-3. 


Figure 11-1. External Power Connector 


Pin Signal 

l Not connected 
2,3 Signal ground 
4 Shield ground 
5, 6 +15 VDC 

fi Not connected 


Table 11-3. External Power Connector Signals 


Pin # Name Description 

1,7 Not connected 

2,2 Ground Common electrical ground 

4 Chassis Chassis ground 

5, 6 +15V +15-volt DC input to converter 
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11.2.3 The Internal Converter 
(SS ee en 


The internal converter in the Apple IIc operates with a supply voltage from 
9 to 20 volts DC as provided by the external power supply or its equivalent. 
The internal converter provides enough low-voltage electrical power for the 
built-in electronics plus an external disk drive attached via the 19-pin 
connector. The basic specifications of the internal converter are listed in 
Table 11-4. Minus 5 volts is derived from the — 12 volts (nominal) provided 
by the voltage converter. 


Table 11-4. Internal Converter Specifications 


Input voltage: +9 to 20 VDC 
Maximum power consumption: 25 W 
Supply voltages: +5V +5% 
+12V + 10% 
—12V + 10% 
Maximum supply currents: +5V: LOA 
+12V: 0.6 A continuous 
0.9 A intermittent 
1.5 A surge (for < 100 ms) 
— 12V: 100 mA 


(—5V:  50mA) 


Maximum case temperature: 60° C (140° F) 


The Apple IIc uses a switching-type internal voltage converter as a power 
supply. It is small and lightweight, and it generates less heat than other 
types of voltage converters. 


The voltage converter works by using the DC voltage input to power a 
variable-frequency oscillator. The oscillator drives a small transformer with 
several separate windings to produce the different voltages required. A 
circuit compares the voltage of the +5-volt supply with a reference voltage 
and feeds an error signal back to the oscillator circuit. The oscillator circuit 
uses the error signal to control the duty cycle of its oscillation and keep the 
output voltages in their normal ranges. 
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The converter includes circuitry to protect itself and the other el ectronic 
parts of the Apple IIc by limiting all three output voltages whenever it 
detects one of the following malfunctions: 


O any supply voltage short-circuited to ground 
O any output voltage outside the normal range 


Whenever one of these malfunctions occurs, the protection circu it varies 
the duty cycle of the oscillator, and all the output voltages drop to 0 if they 
cannot be brought back into their normal range. 


11.3 Apple Ilc Overall Block Diagram 


Figure 11-2 is an overall block diagram of the Apple IIc. The following 
sections contain more detailed diagrams of the major parts of the machine. 
A full set of schematic diagrams of the Apple IIc appears in Section 11.14. 


11.4 The 65CO2 Microprocessor 
Oe ie ee a ae 
CMOS (complementary metal-oxide The Apple IIc uses a CMOS 6502 (designated as 65C02) microprocessor as 
semiconductor) is a way of making its central processing unit (CPU). The 65C02 in the Apple IIc runs at a clock 


integrated circuits that require less power hi ; 
is crsie Winner aitibloncsaicas rate of 1.023 MHz and performs up to 500,000 8-bit operations per second. 


NMOS (negative-doped metal-oxide Note: The clock rate is not a very good criterion for comparing. different 

Se MCOn UENO Uren ay ane types of microprocessors. The 65C02 has a simpler instruction cycle than 
most other microprocessors and it uses instruction pipelining for faster 
processing. The speed of the 65C02 with a 1-MHz clock is equivalent to 
many other types of microprocessors with clock rates up to 5 MHz. 


In addition to requiring less power than earlier NMOS 6502 processors, the 
These instructions are described in 65C02 in the Apple IIc has 27 new instructions. However, prograrms that use 
Appendix A. these additional instructions are not backward compatible with other 
Apple II series computers that are not equipped with a CMOS 650 2. 


11.4.1 65C02 Block Diagram 


(ae eee ee eee eee 

Figure 11-3 is a block diagram of the 65C02 microprocessor. Table: 11-5 
contains the general specifications of this chip. The 65C02 has a 16-bit 
address bus, giving it an address space of 64K bytes. The Apple II< uses 
special techniques to address a total of more than 64K (see Chapter 2). 


22() Chapter 11: Hardware Implementation 


Figure 11-2. Apple IIc Block Diagram 
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Figure 11-3. 65C02 Block Diagram 
Copyright 1982, NCR Corporation. Used by permission of NCR Corporation, Dayton, Ohio. 
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Table 11-5. 65C02 Microprocessor Specifications 


Type: 65002 

Register complement: 8-bit accumulator (A) 
8-bit index registers (X,Y) 
8-bit stack pointer (S) 


8-bit processor status (P) 
16-bit program counter (PC) 


Data bus: 8 bits wide 
Address bus: 16 bits wide 
Address range: 65,5386 (64K) 
Interrupts: IRQ (maskable) 
NMI (nonmaskable) 
BRK (programmed) 
Operating voltage: +5V (+5%) 
Power dissipation: 5 mW (at 1 MHz) 


11.4.2 65C02 Timing 


The Apple IIc’s operation is controlled by a set of synchronous timing 
signals, sometimes called clock signals. The Apple IIc uses a 14.318-MHz 
master timing signal, called 14M, to produce all the other timing signals. 
These timing signals perform two major tasks: controlling the computing 
functions, and generating the video display. The timing signals directly 
involved with the 65C02’s operation are described in this section. Other 
timing signals are described in Sections 11.6.2, 11.9.8, and 11.9.4. 


The relationships of the main 65C02 timing signals are diagrammed in 
Figure 11-4, and the signals are listed in Table 11-6. The 65C02 clock signals 
are @1 and ¢0, complementary signals at a frequency of 1.0227 MHz. The 
Apple IIc signal named ¢0 is similar to the signal called ¢2 in Appendix A 
(it isn’t identical—it’s a tiny bit early). 
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Figure 11-4. 65C02 Timing Signals 
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Table 11-6. 65C02 Timing Signal Descriptions 


Signal Name Description 

14M Master oscillator, 14.318 MHz; also 80-column dot clock 

VID7M Intermediate timing signal and 40-column dot c lock 

Q3 Intermediate timing signal, 2.045 MHz with asymmetrical 
duty cycle 

p0 Phase 0 of 65C02 clock, 1.0227 MHz; complement of ¢1 

gl Phase 1 of 65C02 clock, 1.0227 MHz; complement of ¢0 


Chapter 11: Hardware Implementation 


The 65C02’s operations are related to the clock signals in a simple way: 
internal during #1, external during ¢0. The 65C02 puts an address on the 
address bus during #1. This address is valid not later than 110 nanoseconds 
after $1 goes high and remains valid through all of #0. The 65C02 reads or 
writes data during #0. If the 65C02 is writing, the read/write signal is low 
during ¢0 and the 65C02 puts data on the data bus. The data are valid not 
later than 75 nanoseconds after #0 goes high. If the 65C02 is reading, the 
read/write signal remains high. Data on the data bus must be valid no later 
than 50 nanoseconds before the end of #0. 


More information about the 65C02 and its instruction set is in Appendix A. 


11.5 The Custom Integrated Circuits 

OT a a eRe a a ee) 
Most of the circuitry that controls memory and I/O addressing in the 
Apple IIc is in five custom integrated circuits: 


Oo the memory management unit (MMU) 
the input-output unit (OU) 
the timing generator (TMG) 
the general logic unit (GLU) 


the disk controller unit, also known as the Integrated Woz Machine 
(IWM) 


The soft switches that control the various I/O and addressing modes of the 
Apple IIc are addressable flags inside the MMU, IOU, and GLU. The 
functions of the MMU and IOU are not as independent as their names 
suggest; working together, they generate all the addressing signals. For 
example, the MMU generates the RAM address signals for the CPU, while 
the IOU generates similar RAM address signals for the video display and 
most I/O hardware addresses. 


Oo Oo o-oo 


11.5.1 The Memory Management Unit (MMU) 
SSS rae a ee ee ee 


The circuitry inside the MMU implements these soft switches: 


Page 2 display (Page2) (described in Chapter 5) 
high-resolution mode (HiRes) (Chapter 5) 

store to 80-column display (80Store) (Chapter 5) 
select bank 2 (Bank2) (Chapter 2) 

enable bank-switched RAM (EnICRAM) (Chapter 2) 


fo oo ou 
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important! 


Figure 11-5. The MMU Pinouts 
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read auxiliary memory (RAMRd) (Chapter 2) 
write auxiliary memory (RAMWrt) (Chapter 2) 
auxiliary stack and zero page (AItZP) (Chapter 2) 
reset mouse Y interrupt (RstYInt) (Chapter 9) 
reset mouse X interrupt (RstXInt) (Chapter 9) 


These switches are available on MMU pin 21, which is connected to bit 7 on 
the data bus. Figure 11-5 shows the MMU pinouts; Table 11-7 describes the 


signals. 


A signal name followed by an asterisk is active low—that is, it is true 
when the signal is at a TTL high (+5V) level. 


The 64K dynamic RAMs used in the Apple IIc use a multiplexed address, as 
described in Section 11.6.2. The MMU generates this multiplexed address 
for memory reading and writing by the 65C02 CPU. 


Table 11-7. The MMU Signal Descriptions 


Pin # Name Description 

l GND Power and signal common 

2 AQ 65C02 address input 

3 g0 Clock phase 0 input 

4 Q3 Timing signal input 

D PRAS* Memory row-address strobe 

6-18 RAO-RA7 Multiplexed address output 

14 R/W* 65C02 read-write control signal 

15 INH* Inhibits main memory (tied to +5V) 

16 C06X* Causes $C06x cutputs to go to 0 during 40 

17 EN80* Enables auxiliary RAM 

18 KBD* Enables keyboard data bits 0-6 

19 ROMEN2* Enables ROM (tied to ROMEN1*) 

20 ROMEN 1* Enables ROM (tied to ROMEN2*) 

21 MD’ State of MMU flags on data bus bit 7 

22 CO7X Causes $C07x outputs to go to 0 during 40 

a3 CASEN* Enables main RAM 

24 SELIO* Goes to 0 during 60 for any access to $C0 page 
except $C08x, Bx, Cx, or Fx 

20 +5V Power 

26-40 Alb5-Al 65C02 address input 
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Figure 11-6. 
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The I OU Pinouts 
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11.5.2 The Input/Output Unit (lIOU) 


Sa ee ee ey 
Input/output unit JOU) implements the following soft switches, all 
described in Chapters 2 and 3: 


Oo Page 2 display (Page2) 


oOo oO oo oa oe 


high-resolution mode (Hikes) 
text mode (TEXT) 

mixed mode (MIXED) 
80-column display (80Col) 
character-set select (AltChar) 
any-key-down (AKD) 

mouse movement (X0, YO) 


o vertical blanking interrupt (VBlInt) 


These switches are available on IOU pin 9, which is connected to bit 7 on 
the data bus. Figure 11-6 shows the IOU pinouts; Table 11-8 describes the 


signals. 


The 64K dynamic RAMs used in the Apple IIc require a multiplexed 
address, as described in Section 11.6.2. The IOU generates this multiplexed 
address during clock phase 1 for the data transfers required for display and 
memory refresh. The way this address is generated is described in 

Section 11.9.1. 


Table 11-8. The IOU Signal Descriptions 


Pin # 
ft 
2 
3 


Name 
GND 
GR 
SEGA 


SEGB 


VC 


Description 
Power and signal common 
Graphics mode enable 


In text mode, works with VC (see pin 5) and SEGB to 
determine character row address 


In text mode, works with VC (see pin 5) and SEGA; in 
graphics mode, selects high-resolution when low, 
low-resolution when high 


Displays vertical counter bit: in text mode, SEGA, 
SEGB, and VC determine which of the eight rows of a 
character’s dot pattern to display; in low-resolution, 
selects upper or lower block defined by a byte 
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Table 11-8—continued. The IOU Signal Descriptions 


Pin # 
6 
1 


17-24 


38, 34 
35, 36 


Name 
80COL* 
CASSO 
SPKR 

MD7 
YMOVE 
N.C. 

N.C. 
PDLO/XMOVE 
R/W* 
RESET* 
IRQ* 
RAO-RA7 
PRAS* 

g0 

Q3 

+5V 

A6 
IOUSELIO* 
AKD 
KSTRB 
VIDD7, VIDD6 
RA9*, RA1O* 
CLRGAT* 
WNDW* 
SYNC” 

HO 


Description 

80-column video enable 

Reserved 

Speaker output signal 

Internal JOU flags for data bus (bit 7) 
Detects mouse movement along Y axis 
Not used 

Not used 

Detects mouse movement along X axis 
65C02 read-write control signal 

Power on and reset output 

Maskable interrupt line to 65C02 
Video refresh multiplexed RAM address (phase 1) 
Row-address strobe (phase 0) 

Master clock phase 0 

Intermediate timing signal 

Power 

Address bit 6 from 65C02 

Derived from the SELIO* output for MMU pin 24 
Any-key-down signal 

Keyboard strobe signal 

Video display data bits 

Video display control bits 

Color-burst gate (enable) 

Displays blanking signal 

Displays synchronization signal 


Displays horizontal timing signal (low bit of character 
counter) 
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11.5.3 The Timing Generator (TMG) 


A custom timing generator chip (TMG) generates several timing and control 
signals in the Apple IIc. The TMG pinouts are shown in Figure 11-7; the 
signals are listed in Table 11-9. 


Figure 11-7. The TMG Pinouts Table 11-9. The TMG Signal Descriptions 


Pin # Name Description 
2 l 14M 14.318-MHz master timing signal input 
; 2 1M 7.159-MHz timing signal 
: 3 CREF 3.0/95-MHz color reference timing signal 
: 4 HO Horizontal video timing signal 
5 VIDD7 Video data bit 7 
6 SEGB Video timing signal 
7 TEXT Video display text-modes enable 
8 CASEN* RAM enable (CAS enable) 
9 80COL* Enables 80-column display mode 
10 GND Power and signal common 
11 TMGEN* Enables master timing 
12 LDPS* Video shift-register load enable 
13 VID7M Video dot clock enable, 7 MHz or continuous 0 
14 gl Phase 1 system clock 
15 oO Phase 0 system clock 
16 Q3 Intermediate timing and strobe signal 
ii PCAS* RAM column-address strobe 
18 N.C. Reserved for testing 
19 PRAS* RAM row-address strobe 
20) +5V Power 
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Figure 11-8. The GLU Pinouts 
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11.5.4 The General Logic Unit (GLU) 


The general logic unit is a single chip that contains the miscellaneous logic 
required for the system. It provides 


all RAM read/write timing 
double-high-resolution enable/disable 
soft-switch status registers 

write command registers 

IOU control for mouse interrupts 
double-high-resolution soft switches. 


OOdO dQ 


O 


The GLU’s pin assignments are shown in Figure 11-8 and its signals are 


listed in Table 11-10. 


Table 11-10. The GLU Signal Descriptions 


Pin # Name 


Nt 


14M 


2, 3-7 AQ, A3-A7 


1%, 


p0 
SELIO* 


GR 
RESET* 
GND 
GLUEN* 
MD7 
R/W* 
TEXT 


18 N.C. 
CREF 
7M 
DISK* 


Description 
Master clock (14.818 MHz) 


Address lines to select least significant byte of 
addresses on C0 page 


Phase 0 of 1.0227-MHz processor sync clock 


Device select for selecting most significant byte of the 
address 


Graphics mode select line 

Master reset for system; resets GLU 

Ground reference and negative supply 

Enables GLU 

Indicates status of MMU flags on data bus bit 7 
Read/write qualifier input from processor 


Signal used to generate video timing in 
double-high-resolution or not-graphics 


Not used 
Color reference signal 
7-MHz clock output 


Disk controller device select output 
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For further information on group code 
recording, refer to Section 11.10. 


Figure 11-9. The IWM Pinouts 


SEEKPHO| 1 SEEKPH1 
SEEKPH2 | 2 SEEKPH3 
AO| 3 +5V 
All| 4 Q3 
A2| 5 7M 
A3| 6 RESET* 
DISK* | 7 RDDATA 
WRDATA; 8 WRPROT 
WRREQ*| 9 DR1* 
DO} 10 DR2* 
D1| 11 D7 
D2 | 12 D6 
D3} 13 D5 
GND | 14 D4 


Table 11-10—continued. The GLU Signal Descriptions 


Pin # Name Description 

22 IOUHOLE Controls IOUSELIO 

23 SER* Serial controller device select output 
24 +5V +5 volt supply 


11.5.5 The Disk Controller Unit (IWM) 


The IWM (for Integrated Woz Machine) is a disk controller that includes, on 
a single chip, all the capabilities of the disk controller card originally 
designed by Steve Wozniak in 1977. 


Right after reset, the [WM is an integrated GCR (group code recording) disk 
drive controller. It also has a status register, mode register, and multiple 
operating modes. It provides both synchronous and asynchronous modes, 
and a fast mode with a data rate twice that of normal disk I/O speeds. 
Figure 11-9 shows the IWM pin assignments; Table 11-11 describes the IWM 
signals. 


Table 11-11. The IWM Signal Descriptions 


Pin # Name Description 

l SEEKPHO Stepper motor control phase 0, one of four 
programmable disk drive motor phase outputs 

2 SEEKPH2 Stepper motor control phase 2 

3 AO The data input to the state bit selected by Al to A3 

4-6 Al-A3 These three inputs select one of the eight bits in the 
state register to be updated. 

7 DISK* Device enable. The falling edge of DISK* latches 


information on Al to A3. The rising edge of either Q3 or 
DISK* qualifies write register data. 


8 WRDATA The serial data output. Each 1-bit causes a transition 
on this output. 

9 WRREQ* This signal is a programmable buffered output line. 

10-13 DO0-D3 DO to D7 make up the bidirectional data bus. 
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Table 11-11—continued. The IWM Signal Descriptions 


Pin # 
14 
15-18 
19 
20) 
21 


22 


23 


24 
25 


26 
27 
28 


Name 
GND 
D4-D7 
DR2* 
DR1* 
WRPROT 


RDDATA 


RESET* 


7M 
Q3 


+5V 
SEEKPH3 
SEEKPH1 


Description 

Ground reference and negative supply 

The remaining bits of the bidirectional data vus 
Drive 2 select 

Drive | select 


Write-protect input; this can be polled via bat 7 of the 
status register. 


Serial data input line. The IWM synchronizes the 
falling transition of each pulse. 


IWM reset: places all IWM outputs in their inactive 
state and sets all state and mode register bits to 0. 


7-MHz clock input 


A 2.0-MHz clock input used to qualify the timing of the 
serial data being written or read 


The +5 volt supply 
Stepper motor control phase 3 


Stepper motor control phase 1 
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The 65C02 microprocessor can directly address 65,536 locations. ‘The 
Apple IIc uses this entire address space, and then some: some are as in 
memory are used for more than one function. The following sections 
describe the memory devices used in the Apple IIc and the way they are 
addressed. Input and output also use portions of the memory address space; 
refer to Chapter 2 for information. 


Figure 11-10 illustrates the Apple IIc’s overall memory bus organization and 
memory selection signals. 


Note: Some Apple IIc’s have ROMs with 27xx designations, some 
have 23xx. They are functionally equivalent. 
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Figure 11-10. Memory Bus Organization 
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11.6.1 ROM Addressing 
a 


In the Apple IIc the following programs are permanently stored in a type 
23128 16K-by-8-bit ROM (Figure 11-11): 
oO Applesoft editor and interpreter 
oO Monitor 
oO enhanced video firmware 
UniDisk 3.5 The version of the Apple IIc that supports the UniDisk 3.5 uses a 23256 


32K-by-8-bit ROM. It needs the extra space for the Protocol Converter, 
Mini-Assembler, and other added functions that it supports. 
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Figure 11-11. The 23128 ROM Pinouts The ROM is enabled by two signals called ROMEN1 and ROMEN2. (In the 
Note: In the type 23256 ROM, pin #27 Apple IIc, ROMEN1 and ROMEN2 are electrically connected.) The segment 
is Al4. of the ROM enabled by ROMEN] occupies the memory address space from 
$C100 through $DFFF’. The address space from $C300 through $C3FF and 
much of $C800 through $CFFF contains the enhanced video firmware. 


These ROM address allocations are approximately true (Some sp ace sharing 
takes place): 


co ROM addresses $C000 through $COFF are never available. 


oO ROM addresses $C100 and $C200 are entry points to firmware for serial 
ports 1 and 2, respectively. 


oO ROM address $C400 is the entry point to mouse interface support. 
co ROM addresses $C500 through $C5FF are reserved. 


co ROM address $C600 is the entry point to firmware for the built-in and 
external disk drives. The built-in drive is considered slot 6 drive 1 or its 
equivalent. The external drive is considered slot 6 drive 2. 


co ROM addresses starting at $C700 support (from the Monitor) t he external 
drive as if it were slot 7 drive 1, for external-drive startup only. 

oO Addresses $D000 through $F7FF contain the Applesoft BASIC 
interpreter; addresses $F800 through $FFFF contain the Monitor 
firmware. 


The other ROMs in the Apple IIc are a type 2316 ROM (Figure 11-12) used 
for the keyboard character decoder, and a type 2364 ROM (Figure 11-18) 
used for character sets for the video display. This 2364 ROM is rather large 
because it includes a section of straight-through bit-mapping for the 
graphics modes. This way, graphics display video can pass through the 
same circuits as text without additional switching circuitry. 


, 
2 
3 
4 
5 
6 
7 
8 


11.6.2 RAM Addressing 


———=—=—==— === ae 

The RAM (programmable) memory in the Apple IIc is used both for program 
and data storage and for the video display. The areas in RAM that are used 
for the display are accessed both by the 65C02 microprocessor and by the 
video display circuits. In some computers, this dual access results in 
addressing conflicts (cycle stealing) that can cause temporary dropouts in 
the video display. This problem does not occur in the Apple IIc, thanks to 
the way the microprocessor and the video circuits share the memory. 
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Figure 11-14. The 64K RAM Pinouts 
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The memory circuits in the Apple IIc take advantage of the two-phase 
system clock described in Section 11.4.2 to interleave the microprocessor 
memory accesses and the display memory accesses so that they never 
interfere with each other. The microprocessor reads or writes to RAM only 
during ¢0, and the display circuits read data only during ¢1. 


Dynamic RAM Refreshment 


The image on a video display is not permanent; it fades rapidly and must be 
refreshed periodically. To refresh the video display, the Apple IIc reads the 
data in the active display page and sends them to the display. To prevent 
visible flicker in the display, and to conform to standard practice for 
broadcast video, the Apple IIc refreshes the display 60 times per second. 


The dynamic RAM devices used in the Apple IIc also need a kind of 
refreshment, because the data are stored in the form of electric charges that 
diminish with time and must be replenished. The Apple IIc is designed so 
that refreshing the display also refreshes the dynamic RAMs. The next few 
paragraphs explain how this is done. 


The job of refreshing the dynamic RAM devices is minimized by the 
structure of the devices themselves. The individual data cells in each RAM 
device are arranged in a rectangular array of rows and columns. When the 
device is addressed, the part of the address that specifies a row is presented 
first, followed by the address of the column. Splitting information into parts 
that follow each other in time is called multiplexing. Since only half of the 
address is needed at one time, multiplexing the address reduces the number 
of pins needed for connecting the RAMs (Figure 11-14). 


Different manufacturers’ 64K RAMs have cell arrays of either 128 rows by 
512 columns or 256 rows by 256 columns. Only the row portion of the 
address is used in refreshing the RAMs. 


Now consider how the display is refreshed. As described in Section 11.9.1, 
the display circuitry generates a sequence of 8,192 memory addresses in 
high-resolution mode; in text and low-resolution modes, this sequence is the 
1,024 display-page addresses repeated 8 times. The display address cycles 
through this sequence 60 times a second, or once every 17 milliseconds. The 
way the low-order address lines are assigned to the RAMs, the row address 
cycles through all 256 possible values once every 2 milliseconds (see 

Table 11-12). This more than satisfies the refresh requirements of the 
dynamic RAMs. 
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Table 11-12. RAM Address Multiplexing 


Mux’d Row Column 
Address Address Address 
RAO AO AY 

RAI Al A6 

RA2 A2 Al0 
RA3 A8 All 

RA4 A4 Al2 
RAD Ad Al8 
RA6 AT Al4 
RA7 A8 Ald 


Dynamic RAM Timing 


The Apple Ilc’s microprocessor clock runs at a speed of 1.023 MHz, but the 
interleaving of CPU and display cycles means that the RAM is being 
accessed at a 2-MHz rate, or a cycle time of just under 500 nanoseconds. 
Data for the CPU are strobed by the falling edge of ¢0, and display data are 
strobed by the falling edge of @1, as shown in Figure 11-15. 


The RAM timing looks complicated because the RAM address is 
multiplexed, as described in the previous section. The MMU takes care of 
multiplexing the address for the CPU cycle, and the IOU performs the same 
function for the display cycle. The multiplexed address is sent to the 

RAM ICs over the lines labeled RAO-RA7 (Table 11-13). Along with the 
other timing signals, the TMG generates two signals that control the RAM 
addressing: row-address strobe (RAS) and column-address strobe (CAS). 


Table 11-13. RAM Timing Signals 


Signal 

Name Description 

0 Clock phase 0 (CPU phase) 

ol Clock phase 1 (display phase) 

RAS Row-address strobe 

CAS Column-address strobe 

Q3 Alternate RAM/column-address strobe 
RAO-RA7 Multiplexed address bus 

MDO-MD7 Internal data bus 
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Figure 11-15. RAM Timing Signals 
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11.7 The Keyboard 


The Apple IIc’s keyboard is a matrix of keyswitches connected to an 
AY-3600-type keyboard decoder via a ribbon cable and a 26-pin connector 
(Figure 11-16). The AY-3600 scans the array of keys over and over to detect 
any keys pressed. The scanning rate is set by the external resistor-capacitor 
network made up of C46 and R6. The debounce time is also set externally, 
by C45. 


11.7 The Keyboard doi 


Figure 11-16. Keyboard Circuit Diagram 
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The AY-3600’s outputs include five bits of key code plus separate lines for 
CONTROL, SHIFT, any-key-down, and keyboard strobe. The any-key-down 
and keyboard-strobe lines are connected to the IOU, which addresses them 
as soft switches. The key-code line and CONTROL and SHIFT are inputs to 
a separate 2316 ROM. The ROM translates them to the character codes that 
are enabled onto the data bus by signals named KBD* and ENKBD*. The 
KBD* signal is enabled by the MMU whenever a program reads 

location $C000, as described in Chapter 2. 


Figure 11-17 illustrates the events that occur when a key is pressed, when 
the keypress is detected by a program, and when a key is pressed and held 
for more than about a second. 


Figure 11-17. Key board Signals 
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11.8 The Speaker 


a 5 ee Re nw eR ge ek ee 


AUD is an audio-amplifier hybrid circuit. 


240) 


The Apple IIc’s built-in loudspeaker is controlled by a single bit of output 
from the input/output unit (OU), amplified by a hybrid circuit 
(Figure 11-18). 


Figure 11-18. Speaker Circuit Diagram 
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11.8.1 Volume Control 
ee inne ee ea 


There is a 500-ohm variable resistor feeding anywhere from 0 to 5 volts to 
pin 5 of AUD to control the speaker volume. This potentiometer controls the 
volume of both the built-in speaker and whatever is plugged into the output 
jack. 


11.8.2 Output Jack 


SSS ee 

Next to the volume control, along the lower-left side of the Apple IIc case, 
there is a 3.5-mm audio output jack. Although speaker output is monaural, 
the jack accommodates stereo headphone plugs (as well as monaural), 
providing sound to both channels. Inserting a headphone plug into the jack 
disconnects the built-in speaker. 
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11.9 The Video Display 

a ae a a 
The Apple IIc produces a video signal that creates a display on a standard 
video monitor or, if you add an RF modulator, on a black-and-white or color 
television set. The video signal is a composite made up of the data that are 
being displayed plus the horizontal and vertical synchronization signals that 
the video monitor uses to arrange the lines of display data on the screen. 


Note: Apple IIc computers manufactured for sale in the USA generate a 
video signal that is compatible with the standards set by the NTSC 
(National Television Standards Committee). Apple IIc’s used in European 
countries require an external adapter to provide video that is compatible 
with the standard used there, which is called PAL (for phase alternating 
lines ). References to the PAL standard are found in the bibliography at 
the end of this manual. This manual describes only the NTSC version of 
the video circuits. 


The display portion of the video signal is a time-varying voltage generated 
from a stream of data bits, where a 1 corresponds to a voltage that generates 
a bright dot, and a 0 to a dark dot. The display bit stream is generated in 
bursts that correspond to the horizontal lines of dots on the video screen. 
The signal named WNDW* is low during these bursts. 


During the time intervals between bursts of data, nothing is displayed on 
the screen. During these intervals, called the blanking intervals, the display 
is blank and the WNDW* signal is high. The synchronization signals, called 
sync for short, are produced by making the signal named SYNC* low during 
portions of the blanking intervals. The sync pulses are at a voltage 
equivalent to blacker-than-black video and don’t show on the screen. 


11.9.1 The Video Counters 


Se ne 

The address and timing signals that control the generation of the video 
display are all derived from a chain of counters inside the IOU. Only a few 
of these counter signals are accessible from outside the IOU, but they are all 
important in understanding the operation of the display generation process, 
particularly the display memory addressing described in the next section. 


The horizontal counter is made up of seven stages: HO, H1, H2, H3, H4, H5, 
and HPE*. The input to the horizontal counter is the 1-MHz signal that 
controls the reading of data being displayed. The complete cycle of the 
horizontal counter consists of 65 states. The six bits HO through H5 count 
from 0 to 64, then start over at 0. Whenever this happens, HPE* forces 
another count with HO through Hod held at 0, extending the total count to 65. 
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The IOU uses the 40 horizontal count values from 25 through 64 in 
generating the low-order part of the display data address, as desc ribed in 
Section 11.9.3. The IOU uses the count values from 0 to 24 to generate the 
horizontal blanking, the horizontal sync pulse, and the color-burst gate. 


When the horizontal count gets to 65, it signals the end of a line by 
triggering the vertical counter. The vertical counter has nine stages: 

VA, VB, VC, VO, V1, V2, V3, V4, and V5. When the vertical count 

reaches 262, the IOU resets it and starts counting again from 0. Only the 
first 192 scanning lines are actually displayed; the IOU uses the vertical 
counts from 192 to 262 to generate the vertical blanking and sync pulse. 
Nothing is displayed during the vertical blanking interval. (The vertical line 
count is 262 rather than the standard 262.5 because, unlike normal 
television, the Apple IIc’s video display is not interlaced. ) 


11.9.2 Display Memory Addressing 
SSS a eee ee ee 


As described in Section 5.7, data bytes are not stored in memory in the same 
sequence in which they appear on the display. You can get an idea of the 
way the display data are stored by using the Monitor to set the display to 
graphics mode, then storing data starting at the beginning of the display 
page at hexadecimal $0400 and watching the effect on the display. If you do 
this, you should use the graphics display instead of text to avoid confusion: 
the text display is also used for Monitor input and output. 


If you want your program to display data by storing them directly into the 
display memory, you must first transform the display coordinates into the 
appropriate memory addresses, as shown in Chapter 2. The descriptions 
that follow will help you understand how this address transformation is 
done and why it is necessary. 


The address transformation that folds three rows of 40 display bytes into 
128 contiguous memory locations is the same for all display modes, so it is 
described first. The differences among the different display modes are 
described in Section 11.9.4. 


11.9.3 Display Address Mapping 
— a ee ae aes 


Consider the simplest display on the Apple IIc, the 40-column text mode. To 
address 40 columns requires 6 bits, and to address 24 rows requires another 
5 bits, for a total of 11 address bits. Addressing the display this way would 
involve 2048 (2 to the 11th power) bytes of memory to display a mere 

960 characters. The 80-column text mode would require 4096 bytes to 
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The requirements for RAM refreshing are 
discussed in Section 1 1.6.2. 


display 1920 characters. The leftover chunks of memory that were not 
displayed could be used for storing other data, but not easily, because they 
would not be contiguous. 


Instead of using the horizontal and vertical counts to address memory 
directly, the circuitry inside the JOU transforms them into the new address 
signals described below. The transformed display address must meet the 
following criteria: 


O map the 960 bytes of 40-column text into only 1024 bytes 
O scan the low-order address to refresh the dynamic RAMs 
O continue to refresh the RAMs during video blanking 


The transformation involves only horizontal counts H3, H4, and Hd, and 
vertical counts V3 and V4. Vertical count bits VA, VB, and VC address the 
lines making up the characters, and are not involved in the address 
transformation. The remaining low-order count bits, HO, H1, H2, V0, V1, 
and V2 are used directly, and are not involved in the transformation. 


The IOU performs an addition that reduces the five significant count bits to 
four new signals called S0, 51, $2, and S38, where S stands for sum. 

Figure 11-19 is a diagram showing the addition in binary form, with 

V3 appearing as the carry in and Hd appearing as its complement H5*. A 
constant value of 1 appears as the low-order bit of the addend. The carry bit 
generated with the sum is not used. 


If this transformation seems terribly obscure, try it with actual values. For 
example, for the upper-left corner of the display, the vertical count is 0 and 
the horizontal count is 24: HO, H1, H2, and H5 are 0s, and H3 and H4 are Is. 
The value of the sum is 0, so the memory location for the first character on 
the display is the first location in the display page, as you might expect. 


Figure 11-19. Display Address Transformation 


V3 Carry in 
H5* V3 H4 H3 Augend 
V4 H5* V4 1 Addend 
$3 $2 S1 So sum 
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Horizontal bits HO, H1, and H2 and sum bits SO, $1, and $2 make up the 
transformed horizontal address (A0 through A6 in Table 11-14). As the 
horizontal count increases from 24 to 63, the value of the sum (SS 82 S1 S0) 
increases from 0 to 4 and the transformed address goes from 0 to 39, relative 
to the beginning of the display page. 


The low-order three bits of the vertical row counter are V0, V1, amd V2. 
These bits control address bits A7, A8, and A9, as shown in Table 11-14, so 
that rows 0 through 7 start on 128-byte boundaries. When the vertical row 
counter reaches 8, VO, V1, and V2 are 0 again, and V8 changes to 1. If you do 
the addition in Figure 11-19 with H equal to 24 (the horizontal count for the 
first column displayed) and V equal to 8, the sum is 5 and the horizontal 
address is 40: the first character in row 8 is stored in the memory location 
40 bytes from the beginning of the display page. 


Table 11-14 shows how the signals from the video counters are assigned to 
the address lines. H0, H1, and H2 are horizontal-count bits, and V 0, V1, 

and V2 are vertical-count bits. 50, $1, 52, and S38 are the folded address bits 
described above. Table 11-15 shows memory address bits for the display 
modes. 


Table 11-14. Display Memory Addressing 


Memory Display 
Address Bit Address Bit 
AO HO 

Al Hl 

A2 H2 

A3 S0 

A4 Sl] 

Abd $2 

A6 S3 

AZ V0 

A8 Vl 

AQ V2 

Al0 i 

All . 

Al2 * 

Al3 7 

Al4 * 

Ald GND 


* For these address bits, see Table 11-15. 
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Table 11-15. Memory Address Bits for Display Modes 
Note: . means logical AND; ’ means logical NOT. 


Display Modes 

Text and High-Resolution and 
Address Bit Low-Resolution Double-High-Resolution 
Al0 80STORE+PAGE2’ VA 
All 8OSTORE’.PAGE2 VB 
Al2 0 VC 
Al3 0 80STORE+PAGE2’ 
Al4 0 80STORE’.PAGE2 


Figure 11-20 shows how groups of three 40-character rows are stored in 
blocks of 120 contiguous bytes starting on 128-byte address boundaries. 
This diagram is another way of describing the display mapping shown in 
Figure 5-5. Notice that the three rows in each block of 120 bytes are not 
adjacent on the display. 


Figure 11-20. 40-Column Text Display Memory 
Note: Memory locations marked with a double asterisk (**) are screen holes, 
described in Section 2.5.1. 


128 Bytes 
40 Byes 4a Bytes 
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11.9.4 Video Display Modes 


eS SS SSeS ee ae 

The different display modes all use the address-mapping scheme: described 
in Section 11.9.3, but they use different-sized memory areas in different 
locations. This section describes the addressing schemes and the- methods 
of generating the actual video signals for the different display modes. 
Figure 11-21 illustrates the video display circuits discussed in thi s section. 


Figure 11-21. Video Display Circuits 


VIDD7 
HO —» (To TMG) < 
80COL. (To TMG) To RAM g 
VIDD7 PRAS m 
se] 
i) 
=] 
Y. 
re) 
 ] 
.@) 
re) 
5 
SEROUT 2 
S 
NTSC 
VID VIDOUT 
High-Resolution GND 
Graphics 
— Low-Resolution 
g Graphics Q 
= 
a Ov 
Te) oc 
a ua 
am Apple II rd 
a (primary) | (primary) 
set 
Apple lle 
(alternate) | (alternate) 
set 
LANGSW + LANGSW 
up down 


TMG 


HO CREF 


(lOU) 
TEXT 


(1OU) 80COL 


JOJDEUUOD UOISUedxXy CEPI, 


246 Chapter 11: Hardware Implementation 


Text Displays 


The text and low-resolution graphics pages begin at memory locations 
$0400 and $0800. Table 11-15 shows how the display-mode signals control 
the address bits to produce these addresses. Address bits Al0 and All are 
controlled by the settings of Page2 and 80Store, the display-page and 
80-column-video soft switches. Address bits Al2, Al3, and A14 are set to 0. 
Notice that 80Store active inhibits Page2: there is only one display page in 
80-column mode. 


The low-order six bits of each data byte reach the character generator 
directly, via the video data bus VID0-VID5. The two high-order bits are 
modified by the IOU to select between the primary and alternate character 
sets and are sent to the character generator on lines RAY and RA1O. 


The data for each row of characters are read eight times, once for each of 
the eight lines of dots making up the row of characters. The data bits are 
sent to the character generator along with VA, VB, and VC, the low-order 
bits from the vertical counter. For each character being displayed, the 
character generator puts out one of eight stored bit patterns selected by the 
three-bit number made up of VA, VB, and VC. 


The bit patterns from the character generator are loaded into the 74166 
parallel-to-serial shift register and output as a serial bit stream that goes to 
the video output circuit (Figure 11-21). The shift register is controlled by 
signals named LDPS* (for load parallel-to-serial shifter) and VID7M (for 
video 7 MHz). In 40-column mode, LDPS* strobes the output of the character 
generator into the shift register once each microsecond, and VID7M shifts 
the bits out at 7 MHz (Figure 11-22). 


The addressing for the 80-column display is exactly the same as for the 
40-column display: the 40 columns of display memory in auxiliary memory 
are addressed in parallel with the 40 columns in main memory. The data 
from these two memories reach the video data bus (lines VIDO-VID7) via 
separate 74LS374 three-state buffers. These buffers are loaded 
simultaneously (at the rising edge of #0), but their outputs are sent to the 
character generator alternately by the falling edge of #0 and ¢1. In 
80-column mode, LDPS* loads data from the character generator into the 
shift register twice during each microsecond, once during ¢0 and once 
during @1, and VID7M remains low, enabling the clock continuously at 14M 
(Figure 11-238). 
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Figure 11-22. 7-MHz Video Timing Signals (40-Column, Low-Resolution, and High-Resolution Display) 
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| Figure 11-23. 14-MHz Video Timing Signals (80-Column and Double-High-Resolution Display) 
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Low-Resolution Display 


In the graphics modes, VA and VB are not used by the character generator, 
so the IOU uses lines SEGA and SEGB to transmit HO and HIRES*, as shown 
in Table 11-16. 


Table 11-16. Character-Generator Control Signals 


Display Mode SEGA SEGB SEGC 
Text VA VB VC 
Graphics HO HIRES* VC 


The low-resolution graphics display uses VC to divide the eight display lines 
corresponding to a row of characters into two groups of four lines each. 
Each row of data bytes is addressed eight times, the same as in text mode, 
but each byte is interpreted as two nibbles. Each nibble selects 1 of 16 
colors. During the upper four of the eight display lines, VC is low and the 
low-order nibble determines the color. During the lower four display lines, 
VC is high and the high-order nibble determines the color. 


The bit patterns that produce the low-resolution colors are read from the 
character-generator ROM in the same way the bit patterns for characters 
are produced in text mode. The 74166 parallel-to-serial shift regis ter 
converts the bit patterns to a serial bit stream for the video circuits 
(Figure 11-21). 


The video signal generated by the Apple IIc includes a short burst of 
3.58-MHz signal that is used by an NTSC color monitor or color TV set to 
generate a reference 3.58-MHz color signal. The Apple IIc’s video signal 
produces color by interacting with this 3.58-MHz signal inside the monitor or 
TV set. Different bit patterns produce different colors by changing the duty 
cycles and delays of the bit stream relative to the 3.58-MHz color signal. To 
produce the small delays required for so many different colors, the shift 
register runs at 14 MHz and shifts out 14 bits during each cycle of the 1-MHz 
data clock. To generate a stream of 14 bits from each 8-bit patterm read from 
the ROM, the output of the shift register is connected back to the register’s 
serial input to repeat the same 8 bits; the last 2 bits are ignored the second 
time around. 


Each bit pattern is output for the same amount of time as a character: 
1.02 microseconds. Because that is exactly enough time for three and a half 
cycles of the 3.58-MHz color signal, the phase relationship between the bit 
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patterns and the signal changes by a half cycle for each successive pattern. 
To compensate for this, the character generator puts out one of two 
different bit patterns for each nibble, depending on the state of HO, the 
low-order bit of the horizontal counter. 


High-Resolution Display 


The high-resolution graphics pages begin at memory locations $2000 and 
$4000 (decimal 8192 and 16384). These page addresses are selected by 
address bits Al3 and A14. In high-resolution mode, these address bits are 
controlled by PAGE2 and 80STORE, the signals controlled by the 
display-page (Page2) and 80-column-video (80Col) soft switches. As in text 
mode, 80STORE inhibits addressing of the second page because there is 
only one page of 80-column text available for mixed mode. 


In high-resolution graphics mode, the display data are still stored in blocks 
like the one shown in Figure 11-20, but there are eight of these blocks. As 
Tables 11-14 and 11-15 show, vertical counts VA, VB, and VC are used for 
address bits Al0, All, and Al2, which address eight blocks of 1024 bytes 
each. Remember that in the display, VA, VB, and VC count adjacent 
horizontal lines in groups of eight. This addressing scheme maps each of 
those lines into a different 1024-byte block. 


It might help to think of this scheme as a kind of eight-way multiplexer: it’s 
as if eight text displays were combined to produce a single high-resolution 
display, with each text display providing one line of dots in turn, instead of 
a, row of characters. 


The high-resolution bit patterns are produced by the character-generator 
ROM. In this mode, the bit patterns simply reproduce the seven bits of 
display data. The low-order six bits of data reach the ROM via the video 
data bus VIDO-VID5. The IOU sends the other two data bits to the ROM via 
RAY and RA1O. 


The high-resolution colors described in Chapter 2 are produced by the 
interaction between the video signal the bit patterns generate and the 
3.58-MHz color signal generated inside the monitor or TV set. The 
high-resolution bit patterns are always shifted out at 7 MHz, so each dot 
corresponds to a half-cycle of the 3.58-MHz color signal. Any part of the 
video signal that produces a single white dot between two black dots, or 
vice versa, is effectively a short burst of 3.58 MHz and is therefore displayed 
as color. In other words, a bit pattern consisting of alternating 1s and Qs gets 
displayed as a line of color. The high-resolution graphics subroutines 
produce the appropriate bit patterns by masking the data bits with 
alternating 1s and 0s. 
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To produce different colors, the bit patterns must have different phase 
relationships to the 3.58-MHz color signal. If alternating 1s and 0s produce a 
certain color, say green, then reversing the pattern to 0s and 1s will produce 
the complementary color, purple. As in the low-resolution mode, each bit 
pattern corresponds to three and a half cycles of the color signal, so the 
phase relationship between the data bits and the color signal changes by a 
half cycle for each successive byte of data. Here, however, the bit patterns 
produced by the hardware are the same for adjacent bytes; the color 
compensation is performed by the high-resolution software, which uses 
different color masks for data being displayed in even and odd columns. 


To produce other colors, bit patterns must have other timing relationships 
to the 3.58-MHz color signal. In high-resolution mode, the Apple I Ic produces 
two more colors by delaying the output of the shift register by half a dot 

(70 ns), depending on the high-order bit of the data byte being displayed. 
(The high-order bit doesn’t actually get displayed as a dot, because at 7 MHz 
there is only time to shift out seven of the eight bits. ) 


As each byte of data is sent from the character generator to the shift 
register, high-order data bit D7 is also sent to the TMG. If D7 is off, the TMG 
transmits shift-register timing signals LDPS* and VID7M normally. If D7 is 
on, the TMG delays LDPS* and VID7M by 70 nanoseconds, the time 
corresponding to half a dot. The bit pattern that formerly produced green 
now produces orange; the pattern for purple now produces blue. 


A Note About Timing: For 80-column text, the shift register 1s clocked 
at twice normal speed. When 80-column text is used with graphics in 
mixed mode, the TMG controls shift-register timing signals LDPS* and 
VID7M so that the graphics portion of the display works correctly even 
when the text window is in 80-column mode. 


Double-High-Resolution Display 


Double-high-resolution graphics mode displays two bytes in the time 
normally required for one, but it uses high-resolution graphics Pages 1 
and 1X instead of text and low-resolution Pages 1 and 1X. 


Note: There is a second pair, HRP2 and HRP2X, which can be used to 
display a second double-high-resolution page. 


Double-high-resolution graphics mode displays each pair of data bytes as 
14 adjacent dots, 7 from each byte. The high-order bit (color-select bit) of 
each byte is ignored. The auxiliary-memory byte is displayed first, so data 
from auxiliary memory appear in columns 0-6, 14-20, and so on, up to 
columns 547-552. Data from main memory appear in columns 7-13, 21-27, 
and so on, up to 553-559. 
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RGB stands for red, green, and blue, and 
identifies a type of colo r monitor that uses 
independent inputs for the three primary 
colors. 


For further information about 
double-high-resolutiom graphics display, 
refer to the Bibliograplhy. 


VID is a video-amplifirer hybrid circuit. 


As in 80-column text, there are twice as many dots across the display 
screen, so the dots are only half as wide. On a TV set or low-bandwidth (less 
than 14 MHz) monitor, single dots are dimmer than normal. 


Note: Except for some expensive RGB-type color monitors, any video 
monitor with a bandwidth as high as 14 MHz will be a monochrome 
monitor. Monochrome means one color: a monochrome video monitor can 
have a screen color of white, green, orange, or any other single color. 


The main memory and auxiliary memory are connected to the address bus 
in parallel, so both are activated during the display cycle. The rising edge 
of ¢0 clocks a byte of main memory data into the video latch, and a byte of 
auxiliary memory data into the 80 latch (Figure 11-21). 


Phi 1 enables output from the (auxiliary) 80 latch, and 40 enables output 
from the (main) video latch. Output from both latches goes to CHARGEN, 
where GR and SEGB* select high-resolution graphics. LDPS operates at 

2 MHz in this mode, alternately gating the auxiliary byte and main byte into 
the parallel-to-serial shift register. VID7M is active (kept true) for 
double-high-resolution display mode, so when it is ANDed with 14M, the 
result is still 14M. The 14M serial clock signal gates shift register output to 
VID, the video display hybrid circuit, for output to the display device. 


11.9.5 Video Output Signals 
SSE eee ee) 


The stream of video data generated by the display circuits described above 
goes to a hybrid circuit (VID) that adjusts the signals to the proper 
amplitudes and conditions the color burst. 


The resulting video signal is an NTSC-compatible composite-video signal 
that can be displayed on a standard video monitor. The signal is similar to 
the KIA (Electronic Industries Association) standard positive composite 
video. This signal is available in two places in the Apple IIc (Figure 11-24): 


O at the video output connector on the back of the Apple IIc 


O at the video expansion connector (pin 12) on the back panel 
(Table 11-17) 


Monitor Output 


The sleeve of the video output connector at the center of the Apple IIc back 
panel is connected to ground and the tip is connected to the video output 
through a resistor network that attenuates it to about 1 volt and matches its 
impedance to 75 ohms. This arrangement is suitable for most video 
monitors. 
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Figure 11-24. Video Output Back Panel Connectors 


VIDOUT 
Back Panel Video Video Output Connector 
Expansion Connector (For a Monitor) 


(For an RF Modulator 
or Special Adaptor) 
(See Fig. 11-25) 


Video Expansion Output 


The back panel of the Apple IIc has a DB-15 connector for sophisticated 
video interfaces external to the computer. Figure 11-25 shows the pin 
assignments for this connector; Table 11-17 describes the signals. In Table 
11-17, the column labeled Deriv indicates what clock signals the video 
signals are derived from. LDPS, CREF, and PRAS have a maximu:m delay of 
30 ns from the appropriate 14-MHz rising edge. SEROUT is clocked out of a 
74LS166 by the rising edge of 14M and has a maximum delay of 35 ns. 
VIDD7 is driven from a 74LS374 and has a maximum delay of 28 ns from 
the rising and (if 80-column) falling edges of #1. 


To align CREF so it is in the same phase at the beginning of every line, 
certain clock signals must be stretched. This stretch is for one 7M cycle 
(140 ns), and occurs at the end of each video line. All timing signals except 
14M, 7M, and CREF are stretched. 


AWarning The maximum allowable current drain of +12V regulated power at the 
video expansion connector is 300 milliamps. If the external device draws 
more than this, it can damage the computer or cause the power supply to 
shut down. 
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AWarning The signals at the DB-15 on the Apple IIc are not the same as those at the 
DB-15 on the Apple III. Do not attempt to plug a cable intended for one 
into the other. 


Several of these signals, such as 14 MHz, must be buffered within about 
four inches (10 cm) of the back panel connector—preferably inside a 
container directly connected to the back panel. For technical information, 
contact Apple Technical Support. 


Figure 11-25. The Video Expansion Connector Pinouts 
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Pin Signal Pin Signal 

l TEXT 9 PRAS* 

2 14M 10 GR 

3 SYNC* ll SEROUT* 
4 SEGB 12 NTSC 

D 1VSOUND 13 GND 

6 LDPS* 14 VIDD7 

( WNDW* 15 CREF 

8 +12V 


Table 11-17. The Video Expansion Connector Signals 


Pin # Deriv Name Description 

l 0 TEXT — Video text signal from TMG; set to inverse of 
GR, except in double-high-resolution mode 

2 14M 14-MHz master timing signal from the system 
oscillator 

3 Q3 SYNC* _ Displays horizontal and vertical 
synchronization signal from IOU pin 39 

4 PRAS SEGB __ Displays vertical counter bit from IOU pin 4; 


in text mode indicates second low-order 
vertical counter; in graphics mode indicates 
low-resolution 
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Table 11-17—continued. The Video Expansion Connector Signals 


Pin # Deriv Name Description 

5 IVSOUND  One-volt sound signal from pin 5 of the audio 
hybrid circuit (AUD) 

6 14M LDPS* Video shift-register load enable from pin 12 of 
TMG 

7 PRAS WNDW* Active area display blanking; includes both 
horizontal and vertical blanking 

8 +12V Regulated +12 volts DC; can drive 300 mA 

9 14M PRAS* RAM row-address strobe from TMG pin 19 

10 PRAS GR Graphics mode enable from IOU pim 2 

11 14M SEROUT* _ Serialized character-generator output from 
pin 1 of the 74LS166 shift register 

12 NTSC Composite NTSC video signal from VID 
hybrid chip 

13 GND Ground reference and supply 

14 g0 VIDD7 From 74LS374 video latch; causes half-dot 
shift if high 

15 14M CREF Color reference signal from TMG pin 3; 
3.58 MHz 


11.10 Disk I/O 

a TP Eo ee NN Nm te 8 eae | 
Disk I/O—for both the built-in and the external drive—is supported by the 
IWM disk controller unit. The external drive is attached via a DB- 19 
connector. Figure 11-26 shows this connector. Table 11-18 describes the pin 
assignments. Supply voltages come from the power supply; all other signals 
come from the IWM, described in Section 11.5.5. 


AWarning The power available at this connector is for a Disk IIc or similar drive 
only. Do not use power from the external disk connector for any other 
purpose—you may damage the internal voltage converter. To derive 
external power for an attached device, use one of the other connectors 
and observe the current limits given in this manual. 
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Figure 11-26. Disk Drive Connector 


Pin Signal Pin Signal 
1,2,3,4 GND 13 SEEKPH2 
4) —=12V 14 SEEKPH3 
6 +5V 15 WRREQ* 
78 +12V 16 N.C. 

9 EXTINT* 17 DR2* 

10 WRPROT 18 RDDATA 

1] SEEKPHO 19 WRDATA 

12 SEEKPH1 


Table 11-18. Disk Drive Connector Signals 


Connector 

Pin # Name Description 

], 2, 3,4 GND Ground reference and supply 
6 +5V +5 volt supply 

7,8 +12 +12 volt supply 

9 EXTINT* External interrupt 

10 WRPROT _ Write-protect input 
11-14 0-4 Motor phase 0-4 output 
15 WRREQ* Write request 

ie DR1* Drive 1 select 

18 RDDATA _ Read data input 

19 WRDATA Write data output 


11.11 Serial 1/O 


The Apple IIc has built into it two 6551 asynchronous communication 
interface adapters (ACIA) and supporting input and output buffers for 
full-duplex serial communication. Figure 11-27 is a block diagram of the 
Apple [Ic serial ports. ACIA outputs are buffered by a 1448-quad line driver. 
Similarly, ACIA inputs are buffered by a 1489-quad line receiver. 
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Figure 11-27. Serial Port Circuits 
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TD1B 
DTR1iB 
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‘ig 
4 j2 
5 
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Figure 11-28 is a detailed block diagram of the 6551 ACIA. The registers are described in Sections 11.11.1 
through 11.11.4. 


Figure 11-28. 6551 ACIA Block Diagram 
Copyright 1978, Syrertek Inc. Used by permission of Synertek Inc., 3001 Stender, Santa Clara, CA 95052. 


Transmit 


Control CTS* 


Transmit Transmit 
Data Shift TxD 
Register Register 
IRQ* 
Status Interrupt * 
Register Logic ia 
DSR* 
Select 
and RxC 
Control Control Baud Rate 
Logic Register Generator a 
XTAL2 
Receive Receive 
Data Shift RxD 
DBy Register Register 
Data 
Bus 
: Buffers 
DB; <— Command Receive 
Register Control 
DTR* 
RTS* 


The 6551 pin assignments are shown in Figure 11-29 and described in 
Table 11-19. Note that the two 6551s are not used in exactly the same 
way—each one supports a different set of interrupts. 


Port 1 reads external interrupts (EXTINT*) on its Data Set Ready (DSR) 
pin. This input is tied to +5V through a 3.3-KQ pullup resistor. 
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Figure 11-29. The 6551 Pinouts Table 11-19. The 6551 Signal Descriptions 


Pin # 


co aoe NN FO Oo Se OC 


18-25 


Name 
GND 


A4 
Ad 


SER* 
RESET* 
N.C. 
BCLK 
N.C. 
RTS* 
CTS* 
TXD 
N.C. 
RXD 
AO, Al 
+5V 
DSR 


EXTINT* 
KSTRB 


DO-D7 
IRQ* 
$0 
R/W* 


Description 
Power and signal common ground 


Address line 4 to select serial port 1 
Address line 5 to select serial port 2 


Serial device select from GLU 

Resets both serial ports 

Not connected 

Baud rate clock from GLU 

Not connected 

Request to Send output 

Clear to Send input (not used on IIc; tied to ground) 
Transmit Data output 

Not connected 

Receive Data input 

Address lines 0 and 1 

+5 volt supply 

DCD* pin; used on IIc as Data Set Ready input 


DSR* pin; used on IIc as 
External interrupt (port 1 ACIA), or 
Keyboard strobe input (port 2 ACIA; Appendix E) 


8-bit data bus 
Interrupt Request input 
Phase 0) clock pulse 


Read/write select input 
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Figure 11-30. Serial Port Connectors 


Pin Port 1 Port 2 


i DTRIB DTR2B 
2 TD1B TD2B 
3 GND GND 

4 RDIB RD2B 
5) 


DSRIB = =DSR2B 


Table 11-20. Serial Port Connector Signals 


Pin # Name Description 

l DTRIB Data Terminal Ready output 
DTR2B 

2 TDIB Transmit Data output 
TD2B 

3 GND Power and signal common 

4 RDI1B Read Data input 
RD2B 

5 DSR1B Data Set Ready input 
DSR2B 


11.11.1 ACIA Control Register 
a a et 


Figure 11-31 shows the bit assignments for the ACIA control register, which 
the hardware locates at address $CO9B for serial port 1, and $COAB for 
serial port 2. This register determines the number of data and stop bits the 
ACIA will transmit and receive, and the clock source and baud rate to use 
for data transfer. 
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The receiver clock source is derived from the Apple IIc’s TMG chip; the 
resulting baud rates are equal to or up to 2 percent lower than the nominal 
rate. (The EIA standard allows plus or minus 2 percent variation. ) If an 
Apple IIc serial port is used with a modem that is 2 percent above the 
nominal rate, framing errors can occur, especially at 1200 baud and above, 
when using eight data bits. It may be necessary to select a lower baud rate 
for 8-bit binary data transfers. 


Figure 11-31. ACIA Control Register 
Copyright 1978, Synertek Inc. Used by permission of Synertek Inc., 3001 Stender, Santa Clara, CA 95052. 


Port 1 = $C09B 
Port 2 = $COAB 
Control Register 


7}e}s ia} 3t2}ifo. 

Stop Bits | Baud Rate Generator 
; = at olo}lo]o|  16xexternal Clock 
| 80 baud 
stop biti word length c303ko tt 

= 8 bits and parity** 2 
1% stop bits if word length fojo{i1{1] _—_— 10992 
= 5 bits and no parity potijtojto| 13458 
Word vensth potifo{+}] 0 
ai) peewee potitifo] 30 
Length a 
1 | 1200s 
a 
tof fo [2400 
fttot;i{i{ 3600 
ft}rftojto}] 4800 
eer rf fo [a [7200 
0 = External receiver clock paftijijfo] 00 
1 = Baud rate generator patititi}] 92007 


**This allows for 9-bit transmission (8 data plus parity). 


6 5 4 3 2 1 QO 


7 
Hardware Reset | 0 | 0 | 0 | 0 | 0 | 0 | 0 JO | 
Program Reset | - | - | - | - | - | - |= | - | 
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11.11.2 ACIA Command Register 


Figure 11-32 shows the bit assignments for the ACIA command register, 
which the hardware locates at address $CO9A for serial port 1, and at 
$COAA for serial port 2. This register controls specific transmit and receive 
functions: parity checking, echoing input to output, allowing transmit and 
receive interrupts, and setting levels for Data Terminal Ready and Request 
to Send. 


Figure 11-32. ACIA. Command Register 
Copyright 1978, Synertek Inc. Used by permission of Synertek Inc., 83001 Stender, Santa Clara, CA 95052. 


Port 1 = $CO9A 
Port 2 = $COAA 
Command Register 


7leista{sj2tijto 


Parity Check Controls Data Terminal Ready 


a OU 
Parity disabled—no parity bit 
generated, no parity bit received 


O = Disable receiver and all 
interrupts (DTR* high) 


= Enable receiver and all 
interrupts (DTR* low) 


1 | Odd parity received and transmitted 


1 Even parity received and transmitted 
MARK parity bit transmitted; 
received parity check disabled 

1 SPACE parity bit transmitted; 

: received parity check disabled 


Receiver Interrupt Enable 


iRQ* interrupt enabled from bit 3 
of status register 


IRQ* interrupt disabled 


Transmitter Controls 


Transmit RTS Transmitter 
Interrupt Level 


Polo | Disables [Hin [of 
eon te Meds [Enables [tow [On 
for Receiver ee ; 

es Disabled Transmit BRK 


0 = Normal 
1 = Echo (bits 2 and 3 must be zero) 


7 5 4 


6 3 
Hardware Reset | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 
Program Reset | - | - | - | 0 | 0 | 0 | 0] 0 | 
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11.11.3 ACIA Status Register 
ae SS ee eee) 


Figure 11-33 shows the bit assignments for the ACIA status register, which 
is hard-wired to address $C099 for serial port 1, and $COA9 for serial port 2. 
This register reports the condition of the transmit/receive register, errors 
detected during data transfer, and the level of the Data Carrier Detect, Data 
Set Ready, and Interrupt Request lines. 


Figure 11-33. ACIA Status Register 
Copyright 1978, Synertek Inc. Used by permission of Synertek Inc., 800 1 Stender, 
Santa Clara, CA 95052. 


7 ]6]s|4]s]2]1 0 Port 1 = $C099 
7 1 Port 2 = $COA9 
Status Set By Cle ared By 


0 = Noerror 
1 = Error 
0 = No error 
1 = Error 
0 = No error 


-— 


Parity errort Self-clearing* * 


Framing errort Self-clearing * * 


Overrunt Self-clearing** 


anh, 
I 
m 
x 
= 
°o 
a 


Reading receive 
data register 


Receive Data, 
Register full 


Transmit Data, |0 = Not empty Writing to transmit 

Register empty |1 = Empty data register 

Not resettable; 
reflects DCD* 
state 

Not resettable; 


; 0 = DCD* low 
DCO 1 = DCD* high 


, _ sell . reflects DSR* 
ig state 

0 = No interrupt | Reading status 

1 = Interrupt register 


t No interrupt generated for these conditions. 
** Cleared automatically after a read of RDR 
and the next error-free receipt of data. 


7 5 1 


6 4 3 2 0 
Hardware Reset | 0 | 0 | 0 |o |o [0 | 0 | 0 
Program Reset | - | ~ | - t= |- [- [= | - | 


264 Chapter 11: Hardware Implementation 


11.11.4 ACIA Transmit/Receive Register 


Each ACIA uses the same address—$C098 for serial port 1, $COA8 for serial 
port 2—as temporary storage for both transmission and reception of data. 


When the register is used for transmitting data, bit 0 is the leading bit to be 
transmitted; unused data bits are the high-order bits, which are ignored. 


When the register is used for receiving data, bit 0 is the first bit received; 
unused data bits are the high-order bits, which are set to 0. Parity bits never 
appear in the receive data register; they are stripped off after being used for 
external parity checking. 


11.12 Mouse Input 

TT aa 
The mouse is a hand-held X-Y pointing device that can be rolled along a flat 
surface. It has an attached pushbutton. This section describes how mouse 
movement and direction can be detected and interpreted. 


A mouse has a ball inside its housing that protrudes a small distance so that 
its turning corresponds to mouse movements across a table top. Two wheels 
inside the housing, set at 90-degree angles to each other, follow movements 
of the ball; this causes two disks to rotate. The disks have rectangular holes 
arranged near their edges, making them resemble circular slide mounts 
used with stereoscopic slide viewers. ‘ 


The light from a tiny infrared emitter reaches a photoreceptor whenever 
one of the holes on the disk lies between them. An internal circuit in the 
mouse causes the resulting voltage to swing quickly to a 1 or a 0 value as 
soon as a certain threshold is crossed. The result is something 
approximating a square wave (Figure 11-34) that varies directly with the 
speed of mouse movement. One of these indicates the X component (X0) of 
mouse movement; the other, the Y component (Y0). 


Figure 11-34. Sample Mouse Waveform 
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Under program control, either the rising edge or the falling edge of each 
square wave can cause an interrupt, which the firmware handles by 
updating a counter. However, the program needs to know whether to add or 
to subtract 1 from a counter; that is, it needs to know the direction of X or 

Y movement. 


There is a second infrared emitter /photoreceptor pair almost 180 degrees 
opposite the first pair for each disk. These pairs are positioned in such a 
way that the square waves they generate are approximately a quarter-wave 
offset from their respective movement waves (Figure 11-85). These 
waveforms are called X1 (X direction) and Y1 (Y direction). 


Figure 11-35. Mouse Movement and Direction Waveforms 
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When a rising edge of X0 causes an interrupt, a mouse-driver program can 
immediately check whether X1 is 0 (indicating a movement to the right) 
or 1 (indicating a movement to the left). Similarly, the mouse driver can 
read Y1 immediately after a YO interrupt to determine whether the mouse 
moved up or down one count along the Y axis. 


Figure 11-36 shows the pin assignments for the mouse DB-9 conn ector on 
the back panel. Table 11-21 gives the signal names and descriptions. 
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Figure 11-36. Mouse Connector 


Pin Signal 


MOUSEID* 
+5V 

GND 
XDIR 
XMOVE 
(N.C.) 
MSW* 
YDIR 
YMOVE 


CO CO “1 oO OP & LOK 


Table 11-21. Mouse Connector Signals 


Pin # Name Description 

l MOUSEID* Mouse identifier: when active, disables NE556 hand 
controller timer 

2 +5V Total current drain from this pin must not exceed 
100 mA. 

3 GND System ground 

a XDIR Mouse X-direction indicator 

D XMOVE Mouse X-movement interrupt 

6 N.C. Not connected 

(| MSW* Mouse button 

8 YDIR Mouse Y-direction indicator 

9 YMOVE Mouse Y-movement interrupt 


Figure 11-37 shows the mouse and hand controller circuitry with the mouse 
circuits emphasized. Figure 11-38 illustrates the values of the mouse-button 
circuit when the button is pressed or not pressed. Pressing the button 
disables the NE556 by pulling the reset comparator threshold value up so 
that it cannot reset the flip flop. As a result the mouse-button input value 
remains at a TTL level. 
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Figure 11-37. Mouse Circuits 
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Figure 11-38. Mouse Button Signals 
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11.13 Hand Controller Input 
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Several input signals that are individually controlled via soft switches are 
collectively referred to as the hand controller (game) signals. These signals 
arrive in the Apple IIc via the same DB-9 connector as the one used for the 
mouse (Section 11.12), but the Apple IIc interprets these signals differently. 


The DB-9 connector pin assignments and signal descriptions, as used for 
hand controller input, appear in Figure 11-39 and Table 11-22. 


Even though they are normally used for hand controllers, these signals can 
be used for other simple I/O applications. There are two 1-bit switch inputs, 
labeled Sw0 and Sw, and two analog inputs, called paddles and labeled 
Pdl0 and Pdll. Figure 11-40 shows how to connect the 1-bit switch inputs 
for compatibility with all other Apple II series computers. 


The switch inputs are multiplexed by a 74LS251 8-to-1 multiplexer enabled 
by the C06X* signal from the MMU. Depending on the low-order address, the 
appropriate game input is connected to bit 7 of the data bus. Figure 11-41 
shows the mouse and hand controller circuitry with the hand controller 
circuits highlighted. Figure 11-42 illustrates the values of the hand 
controller switch inputs when the switch is open or closed. 


Figure 11-39. Hand Controller Connector 
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Table 11-22. Hand Controller Connector Signals 


Pin # Name Description 

] GAMESW1 ~~ Switch input 1 (sometimes called paddle button 1) 

2 +5V +5V power supply; total current drain from this pin 
must not exceed 100 mA. 

3 GND System ground 

4,9 Not used for hand controllers 

5, 8 PDLO and Hand controller inputs; each of these must be 

PDLI connected to a 150-KQ variable resistor connected 

to +5V. 

6 N.C. Not connected 

7 GAMESWO — Switch input 0 (sometimes called paddle button 0) 


Figure 11-40. How to Connect Switch Inputs 
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Figure 11-41. Hand Controller Circuits 
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Figure 11-42. Hand Controller Signals 
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The hand controller inputs are connected to the timing inputs of an NE556 
dual analog timer. Addressing $C07X sends a signal from MMU pin 22 that 
resets both timers and causes their outputs to go to 1 (high). A variable 
resistance of up to 150 KQ connected between one of these inputs and the 
+5V supply controls the charging time of one of the two 0.022 microfarad 
capacitors. 


When the voltage on the capacitor passes a certain threshold, the output of 
the NE556 changes back to 0 (low). Programs can determine the setting of a 
variable resistor by resetting the timers and then counting time until the 
selected timer input changes from high to low. The resulting count is 
proportional to the resistance. 


AWarning The only way to ensure correct paddle values is to make sure the output 
of the paddle you intend to read is low before you trigger the timer. 
Triggering the timer starts the charging cycle for the capacitor in each 
paddle circuit; the cycle for one may not be completed by the tame you 
have read the other. If you retrigger or read the other paddle too soon 
(that is, in less than 3 ms), you will get a false value for it. 


11.14 Schematic Diagrams 


a SST Fw) ae NN ee ee ee ee | 
The following pages contain schematic diagrams for the Apple IIc. 
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Appendix A The 65C02 Microprocessor 
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This appendix describes the differences between the 6502 and the 65C02 
microprocessors. It also contains the data sheet for the NCR 65C02 
microprocessor. 


In the data sheet tables, execution times are specified in numbers of cycles. 
One cycle for the Apple IIc equals 0.978 microseconds. 


If you want to write programs that execute on all computers in the Apple II 
series, make sure your code uses only the subset of 65C02 instructions 
present on the 6502. 


A.1 Differences Between 6502 and 65C02 


a ae Re ee a a 
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The data sheet in Section A.2 lists the new 65C02 instructions and 
addressing modes. This section supplements that information by listing the 
instructions whose execution times or results have changed from their 6502 
counterparts. 


A.1.1 Differing Cycle Times 


See ee ee ee) 

In general, differences in execution times are significant only in 
time-dependent code, such as precise wait loops. Fortunately, instructions 
with changed execution times are few. 


Table A-1 lists the 65C02 instructions whose number of instruction 
execution cycles is different from their number on the 6502. 


Table A-1. Cycle Time Differences 


6502 65C02 
Instruction/Mode Opcode Cycles Cycles 
ASL Absolute, X lE 7 6 
DEC Absolute, X DE 7 6 
INC Absolute, X FE 7 6 
JMP (Absolute) 6C 5 6 
LSR Absolute, X 5E (i 6 
ROL Absolute, X 3E 7 6 
ROR Absolute, X TE 7 6 


Appendix A: The 65C02 Microprocessor 


A.1.2 Differing Instruction Results 


Se Se ee ee ee ee eae 
The instructions that have different results from their 6502 equivalents are 


o BIT (in immediate mode) 
oO JMP (indirect, when crossing a page boundary). 


The BIT instruction when used in immediate mode (code $89) leaves 
processor status register bits 7 (N) and 6 (V) unchanged on the 65C02. On 
the 6502, all modes of the BIT instruction have the same effect on the status 
register: the value of memory bit 7 is placed in status bit 7, and memory 

bit 6 is placed in status bit 6. However, all BIT instructions on both versions 
of the processor set status bit 1 (Z) if the memory location being tested 
contains a 0. 


If the JMP indirect instruction (code $6C) references an indirect address 
location that spans a page boundary, the 65C02 fetches the high-order byte 
of the effective address from the first byte of the next page, while the 6502 
fetches it from the first byte of the current page. For example, JMP ($02FF) 
gets ADL from location $02FF on both processors. On the 65C02, ADH 
comes from $0300 while on the 6502, ADH comes from $0200. 
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»® GENERAL DESCRIPTION 


The NCR CMOS 6502 is an 8-bit microprocessor which is soft- 
ware compatible with the NMOS 6502. The NCR65CO2 hardware 
interfaces with all 6500 peripherals. The enhancements include 
ten additional instructions, expanded operational codes and 
two new addressing modes. This microprocessor has all of the ad- 
vantages of CMOS technology: low power consumption, increased 
noise immunity and higher reliability. The CMOS 6502 is a low 
power high performance microprocessor with applications in the 
consumer, business, automotive and communications market. 


» FEATURES 


@ €nhanced software performance including 27 additional OP codes 


encompassing ten new instructions and two additional 
addressing modes. 


® 66 microprocessor instructions. 
® 15 addressing modes. 

© 178 operational codes. 

@ 1MHz, 2MHz operation. 


e Operates at frequencies as low 


as 200 HZ for even lower power - 
consumption (pseudo-static: stop during @2 high). 
© Compatible with NMOS 6500 series 
microprocessors. ~ 
© 64 K-byte addressable memory. 
e ege — ae _s . 
Interrupt capability. | aiNOkX on, 
@ Lower power consumption. Pp) i 4 
4mA @ 1MHz. | aiNoex, KOO 
e +5 vol | a See 
. oye a Ste eet POI i 
© 8-bit bidirectional data bus. a ieag ST be : 
© Bus Compatible with M6800. Fey rte ee 
@ Non-maskable interrupt. j 
ADDRESS ee —— 
© 40 pin dual-in-line packaging. ~~ jccomaronl 
» 
@ 8-bit parallel processing < ay (er = 
. * ° . s BAL”. C5 
® Decimal and binary arithmetic. & ad ae xs 
: : . 5 INPUT DATA 
e Pipeline architecture. ee ae 
@ Programmable stack pointer. 


® Variable length stack. 


¢ Optional internal pullups for _ 
(RDY, 1RQ, SO, NMI and RES) 


LEGEND 


| @16IT LINE 


Specifications are subject to 
change without notice. 


DATA BUS | | 
BUFFER 


=] 


PROCESSOR 
STATUS 
: REGISTER P 


NCR65C02 


RES IRQ NMI 


rit 


INTERRUPT 


| OGIC 
tit 


4 


_| INSTRUCTION 
DECODE 


PIN CONFIGURATION 


@, (OUT) 
50 

Oo (IN) 
NC 


NC 
RW 


NCR65C02 BLOCK DIAGRAM 


a 
<a ROY 
[ - ee SYNC 
wm ML 


be de, 


TIMING 
CONTROL 


CLOCK 
GENERATOR 
OSCILLATOR 


Qo (IN) 


me @; (OUT) 


——-—e 92 (OUT) 
56 
Hw 


DATA 
BUS 
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NCR65C02 


#® ABSOLUTE MAXIMUM RATINGS: 


RATING 
SUPPLY VOLTAGE 
INPUT VOLTAGE 
OPERATING TEMP. 
STORAGE TEMP. 


» PIN FUNCTION 


PIN 
AQ - A15 
DO - D7 
TRO # 
RDY * 
ML 
NMI* 
SYNC 
RES* 
SO * 
NC 
R/W 
VDD 
VSS 
®0 
01, 02 


(Vpop = 5.0V + 5%, Vss =O V, Ta = O° to + 70°C) 


UNIT 
V 
V 
°C 
°C 


FUNCTION 


Address Bus 

Data Bus 

Interrupt Request 
Ready 

Memory Lock 
Non-Maskable Interrupt 
Synchronize 

Reset 

Set Overflow 

No Connection 
Read/Write 

Power Supply (+5V) 
Internal Logic Ground 
Clock Input 

Clock Output 


*This pin has an optional internal pullup for a No Connect condition. 


» DC CHARACTERISTICS 


Input High Voltage 
Bo (IN) 
Input High Voltage 
RES, NMI, RDY, IRQ, Data, S.O. 
‘Input Low Voltage __ 
Qo (IN) 
RES, NMI, RDY, IRQ, Data, S.O. 
Input Leakage Current 
(Vin =0 to 5.25V, Vpp = 5.25V) 
With pullups 
Without pullups 
Three State (Off State) Input Current 
(Vin = 0.4 to 2.4V, Vcc = 5.25V) 
Data Lines 
Output High Voltage 
(lon = -100 Adc, Vpp =4.75V 
SYNC, Data, AO-A15, R/W) 
Out Low Voltage 
(lou = 1.6mAdc, Vpp = 4.75V 
SYNC, Data, AO-A15, R/W) 


Supply Current f = 1MHz 
Supply Current f = 2MHz 
Capacitance 
(Vin =0, Ta = 25°C, f = 1MHz) 

Logic 

Data 

A0-A15, R/W, SYNC 

Qo (IN) 
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NCR65C02 
2s AC CHARACTERISTICS vVop = 5.0v + 5%, Ta = 0°C to 70°C, Load = 1 TTL + 130 pF 


Cc 
=. 


Parameter Symbol 


| Min | Max | Min | Max _| 
Delay Time, Oo (IN) to @2 (OUT) toy | - [ 6 {| - | 60 | 
Delay Time, @1 (OUT) to 02 (OUT) toLy1 | 20 | 20 | -20 | 20 © 
| 0.50 | 


Cycle Time 
Clock Pulse Width Low 


| 460 
Clock Pulse Width High H = 220 | - 
Fall Time, Rise Time te, tr 25 - 25 


5 


o> | os 
vU 


oa] 
=] 
2) 


Address Hold Time taH 
Address Setup Time taps 


Access Time tac | 650 | - | 310 | 

Read Data Hold Time eae ae nS 
Read Data Setup Time i tpsu | 100 | —- | ns 
Write Data Delay Time /tuos |  —- | 30 | 30 nS 
Write Data Hold Time /touw | 20 | - | nS 


Processor Control Setup Time** tecs | 200 | - | 


SYNC Setup Time tsync 
ML Setup Time 
Input Clock Rise/Fall Time tego, trdo 


— 
ws 
oO 
=) 

¢p) 


10 
on 
a 
0 
50 Setup Time so | 100 | - | 100 
150 
es 
= 
ao 


+> 
- 


*NCR65CO2 can be held static with @ 2 high. 
**This parameter must only be met to guarantee that the signal will be recognized at the current clock cycle. 


s MICROPROCESSOR OPERATIONAL ENHANCEMENTS 


| Bunection NMOS 6502 Microprocessor NCR65CO02 Micropwocessor 
Indexed addressing across page boundary. | Extra read of invalid address. Extra read of last instruct ion byte. 


All aré NOPs (reserved for future use). 
Op Code Bytes Cycles 
x2 2 2 
X3, X7, XB, XF 1 1 
44 2 3 
54, D4, F4 2 4 
5C 3 8 


Some terminate only by reset. Results 
are undefined. 


Execution of invalid op codes. 


DC, FC 3 


4 
Jump indirect, operand = XXFF. Page address does not increment. Page address increments and adds one 
additional cycle. 
Read/modify/write instructions at One read and two write cycles. Two read and one write cycle. 
effective address. 
Decimal flag. Indeterminate after reset. Initialized to binary mode (D=0) after 
reset and interrupts. 


Flags after decimal operation. Invalid N, V and Z flags Valid flag adds one add&tional cycle. 


Interrupt after fetch of BRK instruc- Interrupt vector is loaded, BRK vector | BRK is executed, then int errupt is 
tion. is ignored. executed. 


» MICROPROCESSOR HARDWARE ENHANCEMENTS 
| NMos6502——0— | NCRESCOZ 


Ignored. Stops processor during 02. 


Assertion of Ready RDY during 
write operations. 


Unused input-only pins (TRO, NMI, Must be connected to low impedance | Connected internally by a high- 
RDY, RES, SO). signal to avoid noise problems. resistance to Vpp (approximately 250 
K ohm.) 
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« TIMING DIAGRAM 


tra Tra, 
a) 
I tory 
0; 
toiy1 t, et i; 
02 ; tot 
ADR, RM as ae oe 
nee tos =| tour 
READ DATA ! 
LLL | XLT] 
syne ee ol 
ME i ee ee ee, 
_ a tecs 
Rov. (RG ee 
—— a eo 
2g ee, a ee 
Note: All timing is referenced from a high voltage of 2.0 volts and a low voltage of 0.8 volts. 
® NEW INSTRUCTION MNEMONICS 
HEX MNEMONIC DESCRIPTION 
80 BRA Branch relative always [Relative] 
3A DEA Decrement accumulator [Accum] 
1A INA Increment accumulator [Accum] 
DA PHX Push X on stack [Implied] 
5A PHY Push Y on stack [Implied] 
FA PLX Pull X from stack [Implied] 
7A PLY Pull Y from stack [Implied] 
9C STZ Store zero [Absolute] 
9E STZ Store zero [ABS, X] 
64 STZ Store zero [Zero page] 
74 STZ Store zero [(ZPG,X] 
1C TRB Test and reset memory bits with accumulator [Absolute] 
14 TRB Test and reset memory bits with accumulator [Zero page] 
Oc TSB Test and set memory bits with accumulator [Absolute] 
04 TSB Test and set memory bits with accumulator [Zero page] 
® ADDITIONAL INSTRUCTION ADDRESSING MODES 
HEX MNEMONIC DESCRIPTION 
72 ADC Add memory to accumulator with carry [(ZPG)] 
32 AND “AND” memory with accumulator [(ZPG) ] 
3C BIT Test memory bits with accumulator [ABS, X] 
34 BIT Test memory bits with accumulator [ZPG, X] 
D2 CMP Compare memory and accumulator [(ZPG) ] 
52 EOR “Exclusive Or’’ memory with accumulator [(ZPG) ] 
7C JMP Jump (New addressing mode) [ABS(IND,X)] 
B2 LDA Load accumulator with memory [((ZPG)] 
12 ORA “OR" memory with accumulator [(ZPG) } 
F2 SBC Subtract memory from accumulator with borrow [(ZPG) ] 
92 STA Store accumulator in memory [(ZPG)] 


A.2 Data Sheet 287 


288 


INCR65C02 


s MICROPROCESSOR PROGRAMMING MODEL 


7 Oo 

ACCUMULATOR A 
7 0] 

INDE X REGISTER Y 
7 0 

INDEX REGISTER X 


15 7 0 
PCH PCL 


» FUNCTIONAL DESCRIPTION 


Timing Control 

The timing control unit keeps track of the instruction 
cycle being monitored. The unit is set to zero each time 
an instruction fetch is executed and is advanced at the 
beginning of each phase one clock pulse for as many 
cycles as is required to complete the instruction. Each 
data transfer which takes place between the registers de- 
pends upon decoding the contents of both the instruc- 
tion register and the timing control unit. 


Program Counter 

The 16-bit program counter provides the addresses which 
step the microprocessor through sequential instructions 
in a program. 


Each time the microprocessor fetches an instruction 
from program memory, the lower byte of the program 
counter (PCL) is placed on the low-order bits of the 
address bus and the higher byte of the program counter 
(PCH) is placed on the high-order 8 bits. The counter is 
incremented each time an instruction or data is fetched 
from program memory. 


Instruction Register and Decode 

Instructions fetched from memory are gated onto the 
internal data bus. These instructions are latched into the 
instruction register, then decoded, along with timing and 
interrupt signals, to generate control signals for the var- 
ious registers. 


Arithmetic and Logic Unit (ALU) 

All arithmetic and logic operations take place in the 
ALU including incrementing and decrementing internal 
registers (except the program counter). The ALU has no 
internal memory and is used only to perform logical and 
transient numerical operations. 


PROGRAM COUNTER PC 


8 7 
LiL] stack POINTER s 


CARRY 1 = TRUE 

ZERO 1 = RESULT ZERO 
TRG DISANBLE 1 = DISABLE 
DECIMAL. MODE 1 = TRUE 
BRK COMIMAND 1 = BRK 
OVERFLO©W 1 = TRUE 
NEGATIWE 1 = NEG. 


Accumulator 

The accumulator is a general purpose 8-bit register that 
stores the results of most arithmetic and lagic operations, 
and in addition, the accumulator usually contains one of 
the two data words used in these operations. 


Index Registers 

There are two 8-bit index registers (X and Y), which 
may be used to count program steps or to provide an 
index value to be used in generating an effective address. 


When executing an instruction which specifies indexed 
addressing, the CPU fetches the op code and the base 
address, and modifies the address by adding the index 
register to it prior to performing the desired operation. 
Pre- or post-indexing of indirect addresses is possible (see 
addressing modes). 


Stack Pointer 

The stack pointer is an 8-bit register used to control the 
addressing of the variable-length stack ora page one. The 
stack pointer is automatically incremented and decre- 
mented under control of the microprocessor to perform 
stack manipulations under direction of eitheer the program 
or interrupts (NMI and IRQ). The stack allows simple 
implementation of nested subroutines and multiple level 
interrupts. The stack pointer should be initialized before 
any interrupts or stack operations occur. 


Processor Status Register 

The 8-bit processor status register contai ns seven status 
flags. Some of the flags are controlled by the program, 
others may be controlled both by the program and the 
CPU. The 6500 instruction set contains a number of 
conditional branch instructions which are designed to 
allow testing of these flags (see microprocessor program- 
ming model). 
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NCR65C02 
# ADDRESSING MODES 


Fifteen addressing modes are available to the user of the 
NCR65CO2 microprocessor. The addressing modes are 
described in the following paragraphs: 


Implied Addressing [Implied} 

In the implied addressing mode, the address containing 
the operand is implicitly stated in the operation code of 
the instruction. 


Accumulator Addressing [Accum] 

This form of addressing is represented with a one byte 
instruction and implies an operation on the accumu- 
lator. 


immediate Addressing [Immediate] 

With immediate addressing, the operand is contained in 
the second byte of the instruction; no further memory 
addressing is required. 


Absolute Addressing [Absolute] 

For absolute addressing, the second byte of the instruc- 
tion specifies the eight low-order bits of the effective 
address, while the third byte specifies the eight high-order 
bits. Therefore, this addressing mode allows access to the 
total 64K bytes of addressable memory. 


Zero Page Addressing [Zero Page] 

Zero page addressing allows shorter code and execution 
times by only fetching the second byte of the instruction 
and assuming a zero high address byte. The careful use 
of zero page addressing can result in significant increase 
in code efficiency. 


Absolute Indexed Addressing [ABS, X or ABS, Y] 
Absolute indexed addressing is used in conjunction with 
X or Y index register and is referred to as ‘‘Absolute, X,”’ 
and ‘‘Absolute, Y.’’ The effective address is formed by 
adding the contents of X or Y to the address contained 
in the second and third bytes of the instruction. This 
mode allows the index register to contain the index or 
count value and the instruction to contain the base 
address. This type of indexing allows any location refer- 
encing and the index to modify multiple fields, resulting 
in reduced coding and execution time. 


Zero Page Indexed Addressing [ZPG, X or ZPG, Y] 

Zero page absolute addressing is used in conjunction 
with the index register and is referred to as ‘’Zero Page, 
X"' or ‘‘Zero Page, Y.’’ The effective address is calculated 
by adding the second byte to the contents of the index 
register. Since this is a form of ‘’Zero Page’’ addressing, 
the content of the second byte references a location in 
page zero. Additionally, due to the ‘’Zero Page’’ address- 
ing nature of this mode, no carry is added to the high- 
order eight bits of memory, and crossing of page boun- 
daries does not occur. 


Relative Addressing [Relative] 
Relative addressing is used only with branch instructions; 
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it establishes a destination for the conditional branch. 
The second byte of the instruction becomes the operand 
which is an “Offset’’ added to the contents of the pro- 
gram counter when the counter is set at the next in- 
struction. The range of the offset is —128 to +127 
bytes from the next instruction. 


Zero Page Indexed Indirect Addressing [(IND, X)] 

With zero page indexed indirect addressing (usually re- 
ferred to as indirect X) the second byte of the instruction 
is added to the contents of the X index register; the 
carry is discarded. The result of this addition points to a 
memory location on page zero whose contents is the low- 
order eight bits of the effective address. The next mem- 
ory location in page zero contains the high-order eight 
bits of the effective address. Both memory locations 
specifying the high- and low-order bytes of the effective 
address must be in page zero. 


*Absolute Indexed Indirect Addressing [ABS(IND, X)] 
(Jump Instruction Only) 

With absolute indexed indirect addressing the contents of 
the second and third instruction bytes are added to the 
X register. The result of this addition, points to a memory 
location containing the lower-order eight bits of the 
effective address. The next memory location contains 
the higher-order eight bits of the effective address. 


Indirect Indexed Addressing [(IND), Y] 

This form of addressing is usually referred to as Indirect, 
Y. The second byte of the instruction points to a mem- 
ory location in page zero. The contents of this memory 
location are added to the contents of the Y index regis- 
ter, the result being the low-order eight bits of the effec- 
tive address. The carry from this addition is added to the 
contents of the next page zero memory location, the 
result being the high-order eight bits of the effective 
address. 


*Zero Page Indirect Addressing {(ZPG)] 
In the zero page indirect addressing mode, the second 
byte of the instruction points to a memory location on 
page zero containing the low-order byte of the effective 
address. The next location on page zero contains the 
high-order byte of the effective address. 


Absolute Indirect Addressing [(ABS)] 

(Jump Instruction Only) 

The second byte of the instruction contains the low-order 
eight bits of a memory location. The high-order eight 
bits of that memory location is contained in the third 
byte of the instruction. The contents of the fully speci- 
fied memory location is the low-order byte of the effec- 
tive address. The next memory location contains the 
high-order byte of the effective address which is loaded 
into the 16 bit program counter. 


NOTE: * = New Address Modes 
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® SIGNAL DESCRIPTION 


Address Bus (A0-A15) 
AO-A15 forms a 16-bit address bus for memory and |/O 
exchanges on the data bus. The output of each address 
line is TTL compatible, capable of driving one standard 
TTL load and 130pF. 


Clocks (09, 04, and 02) 

Qo is a TTL level input that is used to generate the inter- 
nal clocks in the 6502. Two full level output clocks are 
generated by the 6502. The @2 clock output is in phase 
with 0p. The @1 output pin is 180° out of phase with Qo. 
(See timing diagram.) 


Data Bus (D0-D7) 

The data lines (D0-D7) constitute an 8-bit bidirectional 
data bus used for data exchanges to and from the device 
and peripherals. The outputs are three-state buffers 
capable of driving one TTL load and 130 pF. 


Interrupt Request (IRQ) 

This TTL compatible input requests that an interrupt 
sequence begin within the microprocessor. The !RQ is 
sampled during @9 operation; if the interrupt flag in the 
processor status register is zero, the current instruction 
is completed and the interrupt sequence begins during 
@4. The program counter and processor status register 
are stored in the stack. The microprocessor will then set 
the interrupt mask flag high so that no further IRQs 
may occur. At the end of this cycle, the program counter 
low will be loaded from address FFFE, and program 
counter high from location FFFF, transferring program 
control to the memory vector located at these addresses. 
The RDY signal must be in the high state for any inter- 
rupt to be recognized. A 3K ohm external resistor should 
be used for proper wire OR operation. 


Memory Lock (ML) 7 

In a multiprocessor system, the ML output indicates the 
need to defer the rearbitration of the next bus cycle to 
ensure the integrity of read-modify-write instructions. 
ML goes low during ASL, DEC, INC, LSR, ROL, ROR, 
TRB, TSB memory referencing instructions. This signal 
is low for the modify and write cycles. 


Non-Maskable Interrupt (NMI) 

A negative-going edge on this input requests that a non- 
maskable interrupt sequence be generated within the 
microprocessor. The NMI is sampled during @9; the cur- 
rent instruction is completed and the interrupt sequence 
begins during 01. The program counter is loaded with 
the interrupt vector from locations FFFA (low byte) 
and FF FB (high byte), thereby transferring program con- 
trol to the non-maskable interrupt routine. 


Note: Since this interrupt is non-maskable, another NMI 
can occur before the first is finished. Care should be taken 
when using NMI to avoid this. 


NCR65C02 


Ready (RDY) 

This input allows the user to single-cycle the micropro- 
cessor on all cycles including write cycles. A negative 
transition to the low state, during or coincident with 
phase one (01), will halt the microprocessor with the out- 
put address lines reflecting the current address being 
fetched. This condition will remain through a subsequent 
phase two (02) in which the ready signal is low. This fea- 
ture allows microprocessor interfacing with low-speed 
memory as well as direct memory access (DMA). 


Reset (RES) 

This input is used to reset the microprocessor. Reset 
must be held low for at least two clock cycles after 
VDD reaches operating voltage from a power down. A 
positive transistion on this pin will then cause an initiali- 
zation sequence to begin. Likewise, after the system has 
been operating, a low on this line of at least two cycles 
will cease microprocessing activity, followed by initial- 
ization after the positive edge on RES. 


When a positive edge is detected, there is an initialization 
sequence lasting six clock cycles. Then the interrupt 
mask flag is set, the decimal mode is cleared, and the pro- 
gram counter is loaded with the restart vector from loca- 
tions FFFC (low byte) and FFFD (high byte). This is 
the start location for program control. This input should 
be high in normal operation. 


Read/Write (R/W) 

This signal is normally in the high state indicating that 
the microprocessor is reading data from memory or |/O 
bus. In the low state the data bus has valid data from the 
microprocessor to be stored at the addressed memory 
location. 


Set Overflow (SO) 

A negative transition on this line sets the overflow bit in 
the status code register. The signal is sampled on the trail- 
ing edge of 07. 


Synchronize (SYNC) 

This output line is provided to identify those cycles dur- 
ing which the microprocessor is doing an OP CODE 
fetch. The SYNC line goes high during @; of anOP CODE 
fetch and stays high for the remainder of that cycle. If 
the RDY line is pulled low during the @1 clock pulse in 
which SYNC went high, the processor will stop in its 
current state and will remain in the state until the RDY 
line goes high. In this manner, the SYNC signal can be 
used to control RDY to cause single instruction execu- 
tion. 
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NCR65C02 
» INSTRUCTION SET — ALPHABETICAL SEQUENCE 


ADC Add Memory to Accumulator with Carry LOX Load Index X with Memory 
AND "AND” Memory with Accumulator LDY Load tndex Y with Memory 
ASL Shift One Bit Left LSR_ Shift One Bit Right 
BCC Branch on Carry Clear NOP No Operation 
BCS Branch on Carry Set ORA “OR” Memory with Accumulator 
BEQ Branch on Result Zero PHA Push Accumulator on Stack 
BIT Test Memory Bits with Accumulator PHP Push Processor Status on Stack 
BMI Branch on Result Minus *PHX Push Index X on Stack 
BNE Branch on Result not Zero *PHY Push Index Y on Stack 
BPL Branch on Result Plus PLA Pull Accumulator from Stack 
*BRA_ Branch Always PLP Pull Processor Status from Stack 
BRK _ Force Break *PLX Pull Index X from Stack 
BVC_ Branch on Overflow Clear *PLY Pull Index Y from Stack 
BVS_ Branch on Overflow Set ROL Rotate One Bit Left 
CLC Clear Carry Flag ROR Rotate One Bit Right 
CLD Clear Decimal Mode RTI Return from Interrupt 
CLI Clear Interrupt Disable Bit RTS Return from Subroutine 
CLV Clear Overflow Flag SBC Subtract Memory from Accumulator with Borrow 
CMP Compare Memory and Accumulator SEC Set Carry Flag 
CPX Compare Memory and Index X SED Set Decimal Mode 
CPY Compare Memory and Index Y SEI Set Interrupt Disable Bit 
*“DEA Decrement Accumulator STA Store Accumulator in Memory 
DEC Decrement by One STX Store Index X in Memory 
DEX Decrement Index X by One STY Store Index Y in Memory 
DEY Decrement Index Y by One *STZ Store Zero in Memory 
EOR ‘Exclusive-or’’ Memory with Accumulator TAX Transfer Accumulator to index X 
*INA Increment Accumulator TAY Transfer Accumulator to Index Y 
INC Increment by One “TRB Test and Reset Memory Bits with Accumulator 
INX Increment index X by One *TSB Test and Set Memory Bits with Accumulator 
INY Increment Index Y by One TSX Transfer Stack Pointer to Index X 
JMP Jump to New Location TXA_ Transfer Index X to Accumulator 
JSR Jump to New Location Saving Return Address TXS Transfer Index X to Stack Pointer 
LDA Load Accumulator with Memory TYA_ Transfer Index Y to Accumulator 


Note: * = New Instruction 


# MICROPROCESSOR OP CODE TABLE 


BRK ORA a ey a 
ind, X 
BPL ORA |ORA‘T Tro? sna ra CLC ORA a 
rel ind, Y (zpg) zpg, X | zpg, X abs, Y 
JSR ANDO 
abs ind, X 
AND |AND°Tt 
ind, Y (zpg} 
EOR 
ind, X 
EOR OR‘Tt EOR LSR CLI EOR | PHY* 
ie ind, Y poe zpg, X zpg, X abs, Y 


TSB* ORA ASL 

abs abs abs 

TRB* ORA ASL 

abs abs, X abs, X 

BIT AND ROL 

abs abs abs 
SEC AND BIT*T AND ROL 
abs, Y abs, X abs, X abs, X 


EOR LSR 

abs, X abs, X 
JMP 
(abs) 


JmeP°t 


ADC ae - ROR PLA 
ind, X zpg imm 
BVS ADC c°t =o te ROR ADC PLY* 
rel ind, Y a zpg, X | zpg, X zpg, X abs, Y abs (ind, X) 
BRA®* STA ae ee DEY BIT* TXA STY STA sr 
rel ind, X imm abs abs 
BCC STA°T ae STX TYA TXS STZ°* STzZ°* 
rel 7 : (zpg) zpg, X | zpg, 7 zpg, Y Pa : abs a ee abs, X 
LDY LDA LDX LDY LDA LDX TAY LDA TAX LDY LDA LOX 
imm ind, X imm zpg zpg zpg imm abs abs abs 
BCS LDA LDA*T LDY LDA LOX CLV LDA TSX LDY LDA LOX 
rel ind, Y (zpg) zpg, X | zpg, X | zpg, Y abs, Y abs, X abs, X abs, Y 
CPY DEC DEX es a Cc 
a . imm 
CMP*Tt DEC CLO PHX* 
a : (zpg) zpg, X rae : a . raed x 
CPX SBC ee SBC in SBC INC 
imm ind, X imm abs abs 
BEQ SBC sBc*t = SBC INC 
rel ind, Y (zpg) oe 2 x abs, X | abs, X 
PF fof: f2{[s}s4{s {6 tr] ea Le] ce. | 6 oi 2 ie 


Note: * = New OP Codes 
Note: t = New Address Modes 


JMP EOR LSR 
abs abs abs 
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s OPERATIONAL CODES, EXECUTION TIME, AND MEMORY 
REQUIREMENTS 


IMME. | ABSO- | ZERO Uae RELA. ABS PROCESSOR 
DIATE| LUTE | PAGE |ACCU PLIED 2PG, Y ABS, Y| TIVE (IND, x STATUS CODES 
[wwe] orenarion of do oe ol al ie eb be ol bis seize 


ADC/IA+M+C*A F 6 71 79 72 
ANDIAAM?A 29 pre 31 is ae 39 32 
OE 16 1E 
Branch if C=O 90 
Branch if C=1 80 — aoe ee oe 
Branch if Z=1 FO 
AAM (4,5) 2c 
Branch if N=1 (2) 30 
Branch if Z=0 00 
Branch if N=0 10 
Branch Always 80 
Break 00|7 
Branch if V=0 50 
Branch if V=1 70 
18/2 
rs 


Jump to new loc 
Jump Subroutine 

M?eA (1) 
Mex {1) 
Mey 


o-f 3 — ) 
PC +1°PC 
AVM?*A (1) 
A*M, S 1°S 
P*M,S 1°S 


o* 175 M*Y 
Le 9-fe)) a) 
[ee ae (1) 
Return from Inter. 

Return from Subr 


Notes 
1. Add 1 to ‘‘n” if page boundary is crossed. X Index X + Add n No. Cycles 
2. Add 1 to ’’n” if branch occurs to same page. Y Index Y — Subtract # No. Bytes 
Add 2 to ‘‘n” if branch occurs to different page. A Accumulator A And Mg Memory bit 6 
3. Add 1 to ‘’n” if decimal mode. M Memory per effective address V Or M7 Memory bit 7 
4. V bit equals memory bit 6 prior to execution. Ms Memory per stack pointer ¥ Exclusive or 


N bit equals memory bit 7 prior to execution. 
*5. The immediate addressing mode of the BIT instruction leaves bits 6 & 7 
(V & N) in the Processor Status Code Register unchanged. 
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This appendix lists all important RAM and hardware locations in address 
order and briefly describes them. It also provides cross-references to the 
section of the manual where they are described further. Appendix C 
contains a similar list for important firmware addresses. 


The tables in this appendix list addresses in either two or three forms: the 
hexadecimal form (preceded by a dollar sign) for use in assembly language; 
the decimal form for use in Applesoft BASIC; and (for numbers greater than 
32767) the complementary decimal value for use in Apple Integer BASIC. 


B.1 Page $00 


Os ee nt Oe a a ey 
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Table B-1 lists the zero page addresses in hexadecimal and decimal form, 
followed by symbols denoting the firmware or system software t hat uses 
them. 


oO M denotes the Monitor. 

A denotes Applesoft BASIC. 
I denotes Integer BASIC. 

D denotes DOS 3.3. 


P denotes ProDOS. Locations whose contents ProDOS saves and restores 
afterward have a P in parentheses, indicating that ProDOS has no net 
effect on them. 


O O O 0 


Table B-1. Page $00 Use 


Hex Dec Used by Hex Dec Used by 
$00 0 A $10 16 A 
$01 l A $1] 17 A 
$02 2 A $12 18 A 
$03 3 A $13 19 A 
$04 4 A $14 20 A 
$05 D A $15 21 A 
$06 6 $16 22 A 
$07 1 $17 23 A 
$08 8 $18 24 A 
$09 9 $19 25 

$0A 10 A $1A 26 

$0B 1] A $1B 27 

$0C 12 A $1C 28 

$0D 13 A $1D 29 

$0E 14 A $1E 30 

SOF 1d A SIF ol 
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Table B-1—continued. Page $00 Use 


Hex Dec 
$20 32 
$21 33 
$22 34 
$23 35 
$24 36 
$25 Of 
$26 38 
$27 39 
$28 40 
$29 4] 
$2A 42 
$2B 43 
$2C 44 
$2D 45 
$25 46 
$2F 47 
$30 48 
$31 49 
$32 50 
$33 aa 
$34 52 
$35 53 
$36 54 
$37 55 
$38 56 
$39 O/ 
$3A 58 
$3B 59 
$3C 60 
$3D 61 
$3E 62 
$3F 63 
$40 64 
$41 65 
$42 66 
$43 67 
$44 68 
$45 69 
$46 70 
$47 71 


B.1 Page $00 


am 
DH 
O 
—% 
— a 
«<i 


=Sl=SSSS SSS StS SSS SSeS SESS SSB SESES2 2 S55 22222 


ay eae ee ee Ee eae Bo ee ee | 


Se a a 


Hex 


$48 
$49 
S4A 
$4B 
$4C 
$4D 
$4E 
$4F 


$50 
$51 
$52 
$53 
$54 
$55 
$56 
$57 
$58 
$59 
SHA 
$5B 
$5C 
$5D 
$5E 
SOF 


560 
$61 
$62 
$63 
$64 
$65 
$66 
$67 
$68 
$69 
S6A 
$6B 
$6C 
36D 
$6E 
SOF 


Dec 


72 
73 
74 
15 
76 
i 
78 
79 


80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 


96 

97 

98 

99 

100 
101 
102 
108 
104 
105 
106 
107 
108 
109 
110 
111 


Used by 


M 
M 


SSS 525 35. 


errr rrrrrrrrrrrr rrrrrrrrrrr rrr, LS 


ees A ce OE ee ee ee ee BO ee ee ee 


| ee A cee A cee BO cee BO cee A ee OE ee cee BE ce ee ee | 


me oa 
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Table B-I—continued. Page $00 Use 


Hex Dec Used by Hex Dec Used by 
$70 112 Al D $98 152 Al 
$71 118 Al $99 153 Al 
$72 114 Al $0A 154 Al 
$73 115 Al $9B 155 Al 
$74 116 Al $96 156 Al 
$75 117 Al 9D 157 Al 
$76 118 Al $9E 158 Al 
$77 119 A | SOF 159 Al 
a a re 
$7A 122 Al SAl 161 Al 
$7B «128 Al $A2 162 - 
$70 «124 Al SA 163 Al 
$7) 125 Al — 4 
STE «126 A] $A5 165 a 
$7F 127 A] SAG 166 Al 

$A7 167 Al 
$30 128 Al $48 ‘168 AI 
$81 129 Al $A9 (169 Al 
$82 130 Al $AA 170 Al 
$83 131 Al $AB 171 Al 
$84 182 A | $AC 172 Al 
$85 138 A I $AD 173 Al 
$86 134 Al $AE 174 AI 
$87 135 Al $AF 175 Al 
a ee ore 
$8A 138 Al SBl 7 Al 
$8B 139 Al $B2 178 Al 
$80 140 AI $B3 179 A | 
$8D 141 A | $B4 180 Al 
$8E 142 Al $B5 181 Al 
$F 148 Al $B6 182 Al 

$B7 183 Al 
$90 144 Al $B8 184 Al 
$91 145 Al $B9 185 Al 
$92 146 Al SBA 186 Al 
$93 147 Al $BB 187 Al 
$04 148 Al $BC 188 Al 
$95 149 Al $BD 189 Al 
$96 150 A | SBE 190 Al 
$97 151 Al SBF 191 Al 
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Table B-l—continued. Page $00 Use 


Hex 
$C0 
$Cl 
$C2 
$C3 
$C4 
$C5 
$C6 
$C7 
$C8 
$C9 
$CA 
$CB 
$CC 
$CD 
$CE 
$CF 


$D0 
$D1 
$D2 
$D3 
$D4 
$D5 
$D6 
$D7 
$D8 
$D9 
SDA 
$DB 
dDC 
$DD 
SDE 
SDF 


Dec 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 


208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 


B.1 Page $00 


Used by 


rrr rrrrr rr rrr S 


rr rrr Se 


rrr rrr re 


I 


ee SO 


OoOoUo 


Hex 
$E0 
$El 
$E2 
$E3 
$E4 
$E5 
$E6 
SET 
$E8 
$E9 
$EA 
$EB 
$EC 
$ED 
$EE 
SEF 


SFO 
SF 1 
$F2 
$F3 
$F4 
$F5 
SF6 
SFT 
SF8 
SF9 
SFA 
SFB 
SFC 
SFD 
SFE 
SFF 


Dec 
224 
220 
226 
aot 
228 
229 
230 
231 
200 
233 
204 
230 
236 
237 
238 
239 


240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 


Used by 


Pre ree Se > > 


P-PrPrrr rrr LS 
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B.2 Page $03 
ae a a i ee ee eee ee 

Most of page $03 is available for small machine-language prograrns. The 

built-in Monitor uses the top 16 addresses of page $03, as shown in 

Figure B-2; the XFer routine (Section 2.5.3) uses locations $03ED and 

$03EE. If you are using DOS or ProDOS, it also uses the 32 locations $03D0 

through $08EF. 


Table B-2. Page $03 Use 


Hex Dec Section Use 

$03F0 1008 2.6.4 Address of BRK request handler 
$03F1 1009 (normally $59, $FA) 

$03F2 1010 2.6.4, 10.1 Reset vector 

$08F3 1011 

$03F4 1012 2.6.4 Power-up byte (see text) 

$03F5 1018 Jump instruction to Apples oft 

$03F6 1014 &-command handler 

$03F7 1015 (initially $4C, $58, $FF) 

$03F8 1016 10.6.4 Jump instruction to user CONTROL-Y 
$03F9 1017 command handler 

$03FA 1018 

$03FB  —:1019 Jump instruction to NMI interrupt 
$03FC  —- 1020 handler (not used by Apple IIc) 
$08FD 1021 

$03FE =: 1022 2.6.4 Address of user IRQ interru pt handler 
$03FF 1023 


B.3 Screen Holes 

a 5753 Ol Sawer ime ee Tee PCS te ee ee ee ———— a | 
One result of the way the Apple IIc hardware maps display memory on the 
screen is that groups of 8 memory addresses are left over in 16 areas of the 
text and low-resolution display pages—8 areas in main RAM and 8 in 
auxiliary RAM. The firmware uses for these 128 bytes are shown in 
Tables B-3 and B-4. 


298 Appendix B: Memory Map 


Table B-3. Main Memory Screen Hole Allocations 


Hex 


$0478 


$0479 
$047A 
$047B 
$047C 
$047D 
$047E 
$047F 


$04F8 


$04F9 
S04FA 
$04FB 
$04FC 
$04FD 
S04FE 
S04FF 


$0578 
$0579 
$057A 
$057B 


$057C 
$057D 
$0575 
$057F 


$05F8 


S05F9 
SO5FA 
$05FB 
$05FC 
$05FD 
S05FE 
SO5FF 


Dec 


1144 


1145 
1146 
1147 
1148 
1149 
1150 
1151] 


1272 


1273 
1274 
1275 
1276 
1277 
1278 
1279 


1400 
1401 
1402 
1403 


1404 
1405 
1406 
1407 


1528 


1529 
1530 
1531 
1532 
1533 
1534 
1535 
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Section 


9.1.5 


(5 
8.5 


Oso 


9.1.5 


7.5, £.6.3 
8.5, E.6.2 


9.1.5 


K.6.4 
a) 


Description 


Mouse port: low byte of clamping 
minimum 

Reserved for serial port 1 
Reserved for serial port 2 
Reserved 

Low byte of X coordinate 
Reserved for mouse port 
Reserved 

Reserved 


Mouse port: low byte of clamping 
maximum 

Reserved for serial port 1 
Reserved for serial port 2 
Reserved 

Low byte of Y coordinate 
Reserved for mouse port 
Reserved 

Reserved 


Mouse port: high byte of clamping 
minimum 

Port 1 printer width (1-255; 

Q = unlimited) 

Port 2 line length (1-255; 

( = unlimited) 

Cursor horizontal position (80-column 
display) 

High byte of X coordinate 
Reserved for mouse port 

Reserved 

Reserved 


Mouse port: high byte of clamping 
maximum 

Port 1 temporary storage location 
Port 2 temporary storage location 
Reserved 

High byte of Y coordinate 
Reserved for mouse port 

Reserved 

Reserved 
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Table B-3—continued. Main Memory Screen Hole Allocations 


Hex 


30678 
$0679 


S067A 


$067B 
$067C 
$067D 
$067E 
$067F 


$06F8 
$S06F9 
S06FA 
$06FB 
$06FC 
$06FD 
S06FE 
S06FF 


$0778 


$0779 
S077A 
$077B 
$077C 
$077D 
$077E 
$O77F 


S07F8 


$O7F9 
SO7FA 
$07FB 
$07FC 
$07FD 
$07FE 
$O7FF 


Dec 


1656 
1657 


1658 


1659 
1660 
1661 
1662 
1663 


1784 
1785 
1786 
1787 
1788 
1789 
1790 
179] 


1912 


1913 
1914 
1915 
1916 
1917 
1918 
1919 


2040 


2041 
2042 
2043 
2044 
2045 
2046 
2047 


Section 


(BS 


8.5 


9.1.5 


E.6.4 


1.5 
8.5 


9.1.5, B.6.1 


1.5 
8.5 


9.1.5 
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Description 


Reserved 

Indicates when port 1 firmware is 
parsing a command 

Indicates when port 2 firmware is 
parsing a command 

Reserved 

Mouse port: reserved 

Reserved for mouse port 

Reserved 

Reserved 


Reserved 

Current port 1 command character 
Current port 2 command character 
Reserved 

Mouse port: reserved 

Reserved for mouse port 

Reserved 

Reserved 


DEVNO: $n0 = current active port 
number x 16 

Port 1 flags for echo and auto line feed 
Port 2 flags for each and auto line feed 
Reserved 

Mouse port status byte 

Reserved for mouse port 

Reserved 

Reserved 


MSLOT: owner of $C800-$CFFF ($C8, 
video) 

Port 1 current printer colurnn 

Port 2 current line position 

Reserved 

Mouse port mode byte 

Reserved for mouse port 

Reserved 

Reserved 


Table B-4. Auxiliary Memory Screen Hole Allocations 


Hex 


$0478 
$0479 


S047A 
$047B 
$047C 


$047D 


$0475 
$047F 


$04F8 
through 
$04FF 


$0578 
through 
$057F 


$05F8 
through 
$05FF 


$0678 
through 
$067F 


$06F8 
through 
S06FF 


$0778 
through 
$O77F 


$07F8 
through 
SO7FF 


B.3 Screen Holes 


Dec 

1144 
1145 
1146 
1147 
1148 
1149 


1150 
1151 


1272 


1279 
1400 


1407 
1528 


1535 
1656 


1663 
1784 


179] 
1912 


1919 
2040 


2047 


Section 
1.5 
7.5 
7.5 
1.5 
8.5 
8.5 


8.5 
8.5 


Description 


Initial port 1 ACIA control register 
values ($9E) 

Initial port 1 ACIA command register 
values ($0B) 

Initial port 1 characteristics flags ($40) 
Initial port 1 printer width ($50) 

Initial port 2 ACIA control register 
values ($16) 

Initial port 2 ACIA command register 
values ($0B) 

Initial port 2 characteristics flags ($01) 
Initial port 2 line length ($00) 


Reserved 


Reserved 


Reserved 


Reserved 


Reserved 


Reserved 


Reserved 
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B.4 The Hardware Page 

TTT 
Tables B-5 through B-9 list all the hardware locations available for use in 
the Apple IIc. These tables have a column at the left that is not present in 
other tables. This column, labeled RW, indicates the action to take at a 
particular location. 


oO Rmeans read. 
o RRmeans read twice in succession. 


oO R7 means read the byte and then check bit 7; in the use column, see if... 
refers to the condition represented by bit 7 = 1, unless otherwise 
specified. Bit 7 has a value of $80, so if the contents of the location are 
greater than or equal to $80, the bit is on. 


Another way to test bit 7 (the sign bit) is with a BIT instruction, followed 
by BPL (bit 7 was 0) or BMI (bit 7 was 1). 


oO R/W means to either read or write. For writing, the value is unimportant. 
oO W means to write only. The value is unimportant. 

oO N means not to read or write, because the location is reserved. 

An address of the form $C00x refers to the 16 locations from $C000 through 
$COOF. Labels, when they are shown, are simply memory aids. Some of 


them correspond to the labels at those addresses in the firmware, others do 
not. Your program will have to assign a label for it anyway. 


302 Appendix B: Memory Map 


Table B-5. Addresses $C000-$C08F 


RW Hex Dec Neg Dec Label Section Use 
R = $C00x KStrb 4.1 Read keyboard data (bits 0-6) and strobe (bit 7) 
W ~~ $c000 49152 — 16384 80Store 2.5.4, 5.6 Off: Page2 switches Page 1 and 2 
W  $C001 49153 — 16383  80Store 2.5.4, 5.6 On: Page2 switches Page 1 and 1X 
W $0002 49154 — 16382 RAMRd 2.0.2 Off: Read main 48K RAM 
W $C004 49156 — 16380 RAMWrt 2.D.2 Off: Write in main 48K RAM 
W $C005 49157 — 16379 RAMWrt 2.0.2 On: Write in auxiliary 48K RAM 
W = $C006 49158 — 16378 Reserved 
W  $C007 49159 — 16377 Reserved 
W = $C008 49160 — 16376 AltZP 2.4.2 Off: Use main PO, P1, bank-switched RAM 
W ~~ $C009 49161 — 16375  AItZP 2.4.2 On: Use auxiliary PO, Pl, bank-switched RAM 
W  $CO0A 49162 — 16374 Reserved 
W  $CO0B 49163 — 16378 Reserved 
W $C00C 49164 — 16872 80Col 5.6 Off: 40-column display 
W  $c00D 49165 — 16871 80Col 5.6 On: 80-column display 
W $C00E 49166 — 16270 AltChar 5.6 Off: Display primary character set 
W  $C00F 49167 — 16369 AltChar 5.6 On: Display alternate character set 
W  $C0lx 4.1 Clear keyboard strobe ($C00x bit 7) 
R7 = $C010 49168 — 16368 AKD 4.1 See if any key now down; clear strobe 
R7 $011 49169 — 16367 RdBnk2 2.4.2 See if using $D000 bank 2 (or 1) 
R7 = $C012 49170 — 16366 RdLCRAM 2.4.2 See if reading RAM (or ROM) 
R7 ~=—- $018 49171 — 16365 RdRAMRd 2.5.2 See if reading auxiliary 48K RAM (or main) 
R7 $014 49172 — 163864 RdRAMWrt 2.5.2 See if writing auxiliary 48K RAM (or main) 
R $C015 49173 — 16363 RstXInt 9.1.3 Reset mouse XO interrupt 
R7 ~=$C016 A9174 — 16362 RdAltZP 2.4.2 See if auxiliary P0, Pl and bank-switched RAM 
R $C017 49175 — 16361  RstYInt 9.1.3 Reset mouse Y interrupt 
R7 = $C018 49176 — 16360 Rd80Store 2.0.4, 5.6 See if 80Store on (or off) 
R7 $019 49177 — 16359 RstVBl 9.1.3 See if VBlInt off (1); reset it 
R7 ~=$CO1A 49178 — 16358 RdTEXT 5.6 See if text (or graphics) 
R7 = $CO1B 49179 — 163857 RdMIXED 5.6 See if mixed mode switch on 
R7 ~=— $CO1C 49180 — 16356 RdPage2 2.5.4, 5.6 See if Page 2/1X selected (or 1) 
R7 = $C01D 49181 — 16355 RdHiRes 2.0.4, 5.6 See if high-resolution switch on 
R7 = $CO1E 49182 — 16854 RdAltChar 5.6 See if alternate character set (or primary) 
R? ~=—- $COIF 49183 — 16353 Rd80Col 5.6 See if 80-column hardware on 
N $C020 49184 — 16352 
through Reserved (read and write) 
N $C02F 49199 — 16337 
W ~~ $C030 49200 — 16336 Reserved 
R $C030 49200 — 16336 4.2.1 Toggle speaker 
N $C031 49201 — 16335 
through Reserved (read and write) 
N $CO3F 49215 — 16321 
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Table B-6. Addresses $C0040-$C05F 


RW Hex Dec Neg Dec Label Section Use 

R7 =$C040 49216 — 16320 RdXYMsk 9.1.3 See if XO/YO mask set 

R7 = $C041 49217 — 16319 RdVBIMsk 9.1.3 See if VB] mask set 

R7 = $042 49218 —16318 RdX0Edge 9.1.3 See if interrupt on falling X0 edge 

R7  $€048 49219 —16317 RdY0Edge 9.1.3 See if interrupt on falling YO edge 

N $0044 49220 — 16316 Reserved 

N $045 4922] — 16315 Reserved 

N $C046 49222 — 16314 Reserved 

N $C047 49223 — 16313 Reserved 

R $0048 49224 —16312 RstXY 9.1.3 Reset X0/YO interrupt flags 

N $C049 49225 — 16311 Reserved 

N $C04A 49226 — 16310 Reserved 

N $C04B 49227 — 16309 Reserved 

N $C04C 49228 — 16308 Reserved 

N $C04D 49229 — 16307 Reserved 

N $C04E 49230 — 16306 Reserved 

N $CO4F 4923] — 16305 Reserved 

R/W_ $C050 49232 — 16304 TEXT 5.6 Off: Graphics display 

R/W $C051 49233 — 16303 TEXT 5.6 On: Text display 

R/W $C052 49234 — 16302 MIXED 5.6 Off: Text or graphics only 

R/W_ $C058 49235 —16301 MIXED 5.6 On: Combination text and graphics 

R/W $C054 49236 —16300 Page2 2.5.4, 5.6 Off: Use Page 1 

R/W $C055 49237 — 16299 Page2 2.5.4, 5.6 On: Display Page 2 (80Store off); store to Page 
1X (80Store on) 

R/W_ $C056 49238 — 16298 HiRes 2.5.4, 5.6 Off: Low-resolution 

R/W $C057 49239 — 16297 HiRes 2.5.4, 5.6 On: High-resolution; double if 80Col and DHiRes 
on 

N $0058 49240 — 16296 Reserved if IOUDis on ($CO7E bit 7=1) 

R/W DisXY 9.1.3 Disable (mask) mouse X0/Y0 interrupts 

N $C059 49241 — 16295 Reserved if IOUDis on 

R/W EnbXY 9.1.3 Enable (allow) mouse X0/Y0 interrupts 

N $C05A 49249 — 16294 Reserved if IJOUDis on 

R/W DisVB] 9.1.38 Disable (mask) VBL interrupts 

N $C05B 49243 — 16293 Reserved if IOUDis on 

R/W EnVBl 9.1.3 Enable (allow) VBL interrupts 

N $C05C 49244 — 16292 Reserved if IOUDis on 

R/W X0Edge 9.1.38 Interrupt on rising edge of X0 

N $C05D 492.45 — 16291 Reserved if IOUDis on 

R/W XOEdge 9.1.3 Interrupt on falling edge of X0 

R/W $C05E 49246 — 16290 DHiRes 5.6 If IOUDis on: Set double-high-resolution 

R/W YOEdge 9.1.3 If IOUDis off: Interrupt on rising YO 

R/W_ $C05F 49247 — 16289 DHiRes 5.6 If IOUDis on: Clear double-high-resolution 

R/W YOEdge 9.1.8 If IOUDis off: Interrupt on falling YO 
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Table B-7. Addresses $C060-$C07F 


RW 


Hex 


$C06x 
$C060 
$C061 
$C062 
$C063 
$C064 
$C065 
$C066 
$C067 
$C068 
through 
$CO6F 


$C07x 


$C070 
$C071 
through 
$C07D 


$COTE 


$COTF 


Dec 


49248 
49249 
49250 
49251 
49252 
49253 
49254 
49255 
49256 


49263 


4.9264 
49265 


49277 
49278 


49279 


Neg Dec 


— 16288 
— 16287 
— 16286 
— 16285 
— 16284 
— 16283 
— 16282 
— 16281 
— 16280 


— 16273 


— 16272 
— 16271 


— 16259 
— 16258 


— 16257 


Label 


Rd80Sw 
RdBtn0 
RadBtnl 
Rd63 
Pdlo 
Pdll 
Moux] 
MouY1 


PTrig 


RdIOUDis 


IOUDis 


RdDHiRes 


IOUDis 


Section 


4.1 

4.1, 9.1.8 
4.1,9.2 
9:1,9.2 
9.2 

9.2 

9.1.3 
9.1.3 


9.2 


0.6, 9.1.3 


8.6, 9.1.3 
5.6 
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Use 


Reserved (write) 

See if 80/40 switch down (= 40) 
See if mouse button/(G] pressed 
See if switch 1/[é) pressed 

See if mouse button not pressed 

See if hand control button 0 pressed 
See if hand control button 1 pressed 
See if mouse X1 (direction) is high 
See if mouse Y1 (direction) is high 


Reserved (write and read) 


Trigger paddle timer; reset VBlInt; however, 
some $C07x are reserved 
Designated trigger or reset location 


Reserved 


See if IOUDis on; trigger paddle timer; reset 
VBiint 

On: Enable access to DHiRes switch; disable 
$C058-$CO5F IOU access 

See if DHiRes on 

Off: Disable access to DHiRes switch; enable 
$C058-$CO5F IOU access 
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Table B-8. Addresses $C080-$COAF 


306 


Hex 


$0080 
$C081 
$C082 
$0083 
$0084 
$0085 
$0086 
$0087 
$0088 
$0089 
$C08A 
$C08B 
$C08C 
$C08D 
SC08E 
SC08F 


$C090 
through 
$C097 
$098 
$099 
$CO9A 


$C09B 
$C09C 
through 
$CO9F 


$COA0 
through 
$COA7 
$COA8 
$COA9 
$COAA 


$COAB 
$COAC 
through 
SCOAF 


Dec 


49280 
49281 
49282 
49283 
49284 
49285 
49286 
49287 
49288 
49289 
49290 
49291 
49292 
49293 
49294 
49295 


49296 


49303 
49304 
49305 
49306 


49307 
49308 


49311 


49312 
49319 
49320 


49321 
49322 


49323 
49324 


49327 


Neg Dec 


— 16256 
— 16255 
— 16254 
— 16253 
— 16252 
— 16251 
— 16250 
— 16249 
— 16248 
— 16247 
— 16246 
— 16245 
— 16244 
— 16243 
— 16242 
— 16241 


— 16240 


— 16233 
— 16232 
— 16231 
— 16230 


— 16229 
— 16228 


— 16225 


— 16224 
— 16217 
— 16216 


— 16215 
— 16214 


— 16213 
— 16212 


— 16209 


Label 


Section 


2.4.2 
2.4.2 
2.4.2 
2.4.2 


2.4.2 
2.4.2 
2.4.2 
2.4.2 


(0, 14211 
to, Well 
(3, 11.11, 
E 

f0, Lhd] 
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Use 


Read RAM; no write; use $D000 bank 2 
Read ROM, write RAM; use $D000 bank 2 
Read ROM; no write; use $D000 bank 2 
Read and write RAM; use $D000 bank 2 
Reserved 

Reserved 

Reserved 

Reserved 

Read RAM; no write; use $D000 bank 1 
Read ROM, write RAM; use $D000 bank 1 
Read ROM; no write; use $D000 bank 1 
Read and write RAM; use $D000 bank 1 
Reserved 

Reserved 

Reserved 

Reserved 


Reserved 

Port 1 ACIA transmit/receive register 
Port 1 ACIA status register 

Port 1 ACIA command register 

Port 1 ACIA control register 


Reserved 


Reserved 

Port 2 ACIA transmit/receive register 
Port 2 ACIA status register 

Port 2 ACIA command register 

Port 2 ACIA control register 


Reserved 


Table B-9. Addresses $COBO-$COFF 


RW Hex 


2 BFA BZA A BA A BA A wAm 


$COBO 
through 
$COBF 


$C0CO 
through 
$COCF 


$COD0 
through 
$CODF 


$COEO 
through 
$COEF 


$COFO 
through 
$COFF 


Dec 
49328 


49343 
49344 


49359 
49360 


49375 
49376 


49391 
49392 


49407 


Neg Dec 
— 16208 


— 16193 
— 16192 


— 16177 
— 16176 


— 16161 
— 16160 


— 16145 
— 16144 


— 16129 


Label 


Section 


B.4 The Hardware Page 


Use 


Reserved 


Reserved 


Reserved 


Reserved 


Reserved 


307 


Appendix C Important Firmware Locations 


309 


AWarning 


This appendix lists all significant firmware addresses: entry points, 
locations containing the addresses of entry points, and locations where 
machine and device identification bytes reside. 


The Monitor firmware entry points are the only published entry points 
in the sense that they are the only ones that will remain in the same 
locations in future Apple II series computers. 


The firmware protocol identification bytes and offsets will work with 
other Apple II series computers only if used as directed (Section 3.4.2). 


C.1 The Tables 
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This appendix supplements the chapter text by specifying three forms of 
each address: hexadecimal, decimal, and complementary (negative) 
decimal. 


In these tables, some of the addresses are followed by a label. These labels 
are listed only to help you find the named location in the firmware listings, 
or to remember the function found at the address. The Apple IIc contains no 
global label table: your program must assign its own labels to the addresses 
as required. 


There are several types of information at these firmware addresses: actual 
entry points (labeled entry), the low-order byte of an entry point (labeled 
offset), a device or machine identification byte (labeled ident), indicators 
(labeled zdic) specifying whether there are optional routines, vector 
addresses (labeled vector), or an RTS instruction location. 


The column labeled Sectzon contains the number of the section that 
describes the item. If there is no description except in a table in this 
appendix, a section number is not listed. 


Each input/output port has an associated protocol table, as shown in 
Tables C-1 through C-4. Many of the bytes (labeled offset) in the protocol 
tables are the low-order bytes of addresses of I/O routines for the ports; the 
high-order byte of these addresses must be $Cn (where n is the port 
number). This structure is explained in Chapter 3. Although your program 
must perform some extra processing to use these tables, the benefit is 
simplified compatible port and slot I/O for all Apple II series machines. 
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Addresses for serial ports 1 and 2, output port 3, and mouse input port 4 are 
shown in the following four tables. 


Table C-1. Serial Port 1 Addresses 


Hex Dec Neg Dec Label Type Section Description 

$0100 49408 — 16128 entry 8.1.1 Main port 1 entry point 

$0105 49413 — 16123 ident gA2 ID byte ($38) 

$C107 «49415 «S'(ss« 161121 ident 3.4.9 ID byte ($18) 

$C10B 49419 — 16117 ident 8.4.2 Firmware card signature ($01) 
$C10C 49420 — 16116 ident 8.4.2 Super Serial Card ID ($31) 
$C10D 49421 — 16115 offset 7.4 Low-order PInit address 
$C10E 49422 — 16114 offset 7.4 Low-order PRead address 
$C10F 49423 — 16113 offset 7.4 Low-order PWrite address 
$0110 49424 — 16112 offset 7.4 Low-order PStatus address 
$C111 49425 — 16111 indic 3.4.2 Non-zero: no optional routines 


Table C-2. Serial Port 2 Addresses 


Hex Dec Neg Dec Label Type Section Description 

$200 49664 — 15872 entry 3.11 Main port 2 entry point 
$C205 49669 — 15867 ident 3.4.2 ID byte ($88) 

$0207 49671 «= — 15865 ident 3.4.9 ID byte ($18) 

$C20B 49675 — 15861 ident 3.4.2 Firmware card ID ($01) 
$C20C 49676 — 15860 ident 8.4.2 Super Serial Card ID ($31) 
$C20D 49677 — 15859 offset 8.4 Low-order PInit address 
$C20E 49678 — 15858 offset 8.4 Low-order PRead address 
$C20F 49679 — 15857 offset 8.4 Low-order PWrite address 
$0210 49680 — 15856 offset 8.4 Low-order PStatus address 
$C211 49681] — 15855 indic 3.4.2 Non-zero: no optional routines 
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Table C-3. Video Firmware Addresses 


Hex Dec Neg Dec Label Type Section Description 

$C300 49920 — 15616 entry 3.1.1 Main video entry point (out put only) 
$C305 49925 —15611  C8Keyln ident 8.4.2 ID byte ($38) 

$C307 49927 —15609 C8COutl ident 8.4.2 ID byte ($18) 

$C30B 49931 — 15605 ident 8.4.2 Firmware card signature ($01) 
$C30C 49982 — 15604 ident 3.4.2 80-column card ID ($88) 

$C30D 49933 — 15603 offset 5.9 Low-order PInit address 

$C30E 49934 — 15602 offset 5.9 Low-order PRead address 

$C30F 49935 — 15601 offset 5.9 Low-order PWrite address 

$C310 49936 — 15600 offset 5.9 Low-order PStatus address 

$C311 49937 — 15599 MoveAux entry 2.5.3 Routine for main/auxiliary control 


swapping (also called AuxMlove) 


Table C-4. Mouse Port Addresses 


Hex Dec Neg Dec Label Type Section Description 

$0400 50176 — 15360 entry Main mouse entry point 

$0405 50181 — 15855 ident 3.4.2 ID byte ($38) 

$0407 50188 — 15353 ident 3.4.2 ID byte ($18) 

$C40B  —- 50187 — 15349 ident 342 Firmware card signature ($01) 
$C40C ~—- 50188 — 15348 type 3.4.2 X-Y pointing device ID ($20) 
$C40D 50189 — 15347 offset 9.1.4 Low-order PInit address 

$C40E 50190 — 15346 offset 9.1.4 Low-order PRead address 
$C40F 50191 — 15345 offset 9.1.4 Low-order PWrite address 
$0410 50192 — 15344 offset 9.1.4 Low-order PStatus address 
$0411 50193 — 15343 indic 8.4.2 Optional routines follow ($00) 
$0412 50194 — 15342 SetMouse offset 9.1.4 Low-order SetMouse address 
$0413 50195 — 15341 ServeMouse offset 9.1.4 Low-order ServeMouse address 
$0414 50196 — 15340 ReadMouse offset 9.1.4 Low-order ReadMouse address 
$0415 50197 — 15339 ClearMouse offset 9.1.4 Low-order ClearMouse address 
$0416 50198 — 15338 PosMouse offset 9.1.4 Low-order PosMouse addres s 
$C417 50199 — 15837 ClampMouse offset 9.1.4 Low-order ClampMouse add ress 
$0418 50200 — 15336 HomeMouse offset 9.1.4 Low-order HomeMouse address 
$0419 50201 — 15335 —‘InitMouse offset 9.1.4 Low-order InitMouse addres s 
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C.3 Other Video and I/O Firmware Addresses 
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Miscellaneous firmware addresses are listed in Table C-5. 


Table C-5. Apple IIc Enhanced Video and Miscellaneous Firmware 


Hex Dec Neg Dec Label Type Section Description 

$0600 50688 — 14848 entry 6.1 Disk drive firmware entry point 
$0700 50944 — 14592 entry 6.2 External disk startup routine 
$803 51203 — 14333 NewIRQ entry E.1 IRQ handling routine 


C.4 Applesoft BASIC Interpreter Addresses 


a eee) 
The addresses of Applesoft BASIC entry points are listed in the Applesoft 
BASIC Programmer’s Reference Manual. The Applesoft interpreter 
occupies ROM addresses from $D000 through $F7FF. 


C.5 Monitor Addresses 


ee ie i a ee 


Table C-6 lists the Monitor entry points, machine identifier bytes, interrupt 
vectors, and the address of a known RTS instruction. 


Table C-6. Apple Il¢ Monitor Entry Points and Vectors 


Hex Dec Neg Dec Label Type Section Description 

$F800 63488 —2048 PLOT entry 5.8 Plots a low-resolution block 

$F819 63513 —2023  HlLine entry 5.8 Draws low-resolution horizontal line 
$F828 63528 —2008  VLine entry 5.8 Draws low-resolution vertical line 
$F832 63538 —1998  ClrScr entry 5.8 Clears low-resolution screen 

$F 836 63542 —1994 ClrTop entry 5.8 Clears top 40 low-resolution lines 
$F864 63588 —1948  SetCol entry 5.8 Sets low-resolution color (Table 5-4) 
$F871 63601 —1985 SCRN entry 5.8 Reads color of low-resolution block 
$F941 63809 —1727  PrntAX entry 5.8 Displays A and X in hex 

$FO4A 63818 —1718 PrBl2 entry 5.8 Sends X blanks to output 

$FA47 63845 —1691 NewBRK entry B.2 Apple IIc break handler 

$FA62 64098 — 1438 Reset entry 2.6 Hardware reset routine 
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Table C-6—continued. Apple IIc Monitor Entry Points and Vectors 


Hex Dec Neg Dec Label Type Section Description 

$FB1E 64386 —1150  PRead entry 9.2 Reads hand controller position 
SFB6F 64467 —1169 SetPwrC entry 2.6.4 Routine to create power-up byte 
$FBB3 64535 —1101 ident F.1.2 Machine identification byte 
$FBCO 64548 — 1088 ident F.1.2 Machine identification byte 
$FBDD 64477 —1059 ~—_—Belll entry 4.2.2 Sends 1-kHz beep to speaker 
$FC42 64578 — 958 ClrEOP entry 5.8 Clears from cursor to bottom 
$FC58 64600 — 936 HOME entry 5.8 Clears from cursor to upper left 
$FC9C 64668 — 868 ClrEOL entry 5.8 Clears from cursor to end of line 
$FC9E 64670 — 866 CIEOLZ entry 5.8 Clears from BASL to end of line 
$FCA8 64680 — 856 WAIT entry Delays for time specified by A 
$FDOC ‘64780 — 756 RdKey entry 3.2.1 Displays cursor, jumps to KSW 
$FDIB 64795 —74] Keyln entry a2 Waits for keypress, reads key 
$FD385 64821 —715 RdChar entry 4.1.2 Gets input, interprets ESC codes 
$FD67 64871 — 665 GetLnZ entry 4.1.2 Sends CR to output, goes to GetLn 
$FD6A 64874 — 662 GetLn entry 3.2.8 Displays prompt, gets input line 
$FD6F 64879 — 657 GetLn1 entry 4.1.2 No prompt; gets input line 
$FD8B 64907 — 629 CROut1 entry 5.8 Clears to end of line, calls CROut 
$FD8E  —- 649110 — 626 CROut entry 5.8 Sends CR to output 

$FDDA 64986 — 550 PrByte entry 5.8 Sends A to output 

$FDE3 64995 —54] PrHex entry 5.8 Displays low nibble of A in hex 
$FDED 65005 —531 COut entry ou Jumps to CSW 

$F DFO 65008 — 528 COutl entry 3.0.2 Displays A, advances cursor 
$FE2C 65068 — 468 MOVE entry Copies memory elsewhere 

$FE36 65078 — 458 VERIFY entry Compares two blocks of memory 
$FF2D 65325 —2ll PrErr entry 5.8 Sends ERR to output; beeps 
$FF3A 65338 — 198 Bell entry 4.2.2 Sends CONTROL-G to output 
$FF3F 65343 — 193 IORest entry Loads $45-$49 into register s 
$SFF4A 65354 — 182 IOSave entry Stores A, X, Y, P, S at $45-$ 49 
$FF58 65368 — 168 IORTS RTS Location of known RTS instruction 
SFF69 65385 — 151 Monitor entry 10.1 Standard Monitor entry point 
$FFFA —-65580 —6 vector Low-order NMI vector (unused) 
$FFFB —- 65581 —5 vector High-order NMI vector (unused) 
$FFFC  —- 65582 —4 vector Low-order reset vector ($62) 
$FFFD 65533 —3 vector High-order reset vector ($F A) 
SFFFE 65584 —2 IRQVect vector Low-order IRQ vector ($03) 
$FFFF 65535 —|] vector High-order IRQ vector ($CB) 
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This appendix is an overview of the characteristics of operating systems 
and languages when run on the Apple IIc. It is not intended to be a complete 
description. For more information, refer to the manuals that are provided 
with each product. 


D.1 Operating Systems 


I a a a ee ay 
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This section discusses the operating systems that the Apple IIc works with. 
CP/M, and any other operating system that requires an interface card, does 
not work on the Apple IIc. 


D.1.1 ProDOS 


SSS SSS ae 

ProDOS is the preferred disk operating system for the Apple IIc. It supports 
startup from the external disk drive (on original Apple IIc’s with the 
command PR#7), interrupts, and all other hardware and firmware features 
of the Apple IIc. 


D.1.2 DOS 


SSS ee ae) 

The Apple IIc works with DOS 3.3. Its built-in disk drive hardware and 
firmware can also access DOS 38.2 disks by using the BAS/CS disk. DOS 
support is provided for the sake of Apple II series compatibility; neither 
version of DOS takes full advantage of all the features of the Apple IIc. 


D.1.3 Pascal Operating System 
Sn SSS eee ee eee 


Versions 1.2 and later of the Pascal Operating System use the 80/40 switch 
and the interrupt features of the Apple IIc, while remaining compatible with 
the other Apple II series computers. 


While the Apple IIc works with Pascal 1.1, this version of the Pascal 
Operating System does not use the 80/40 switch or handle interrupts. 


The Apple IIc does not work with Pascal 1.0, because the I/O firmware 
entry points of that version of the operating system are rigidly defined 
(rather than being accessed via a table), and the Apple IIc’s built-in 
firmware does not correspond to these entry points. 
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D.2 Languages 
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This section discusses using Apple programming languages with the 
Apple lic. It is also a guide to using this reference manual with these 
languages. 


D.2.1 Applesoft BASIC 
eine Grate nc eect 


The programming examples in this manual are almost entirely in assembly 
language, and so most addresses and values are given in hexadecimal 
notation. 


Use a PEEK in BASIC (instead of LDA in assembly language) to read a 
location, and a POKE (instead of STA) to write to a location. The values 
used by Applesoft must be in decimal, so you will have to convert 
hexadecimal values given in this manual to decimal. (Several tables in this 
manual include decimal equivalents to make the job easier for you. ) 


If you read a hardware address from a BASIC program, you get a value 
between 0 and 255. Bit 7 has a value of 128, so if a soft switch is on, its 
value will be equal to or greater than 128; if the switch is off, the value will 
be less than 128. 


D.2.2 Integer BASIC 


SSS Ss ee eee 
You will have to run a version of DOS in your Apple IIc to use Integer 
BASIC. ProDOS does not support Integer BASIC. 


D.2.3 Pascal 


ae el 

The Pascal language runs on the Apple IIc under versions 1.1 or later of the 
Pascal Operating System. However, for best performance, use Pascal 
versions 1.2 or later. 


D.2.4 FORTRAN 


eee | 

FORTRAN runs under version 1.1 of the Pascal Operating System, which, as 
explained in Section D.1.8, does not detect or use certain Apple IIc features, 
such as the 80/40 switch or auxiliary memory. Therefore, FORTRAN does 
not take advantage of these features either. 
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D.2.5 Logo Il 


Sa 

Apple Logo II works under ProDOS on Apple II series machines with at least 
128K of memory. Logo II is a version of the Logo language originally 
developed from the LISP (LISt Processing) language at MIT as a Language to 
be used for learning. Logo II takes advantage of the Apple II's graphics and 
retains much of the power and flavor of LISP without LISP’s somewhat 
cryptic syntax. 
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This appendix describes the sources of interrupts on the Apple IIc, how the 
firmware handles the interrupts, and how to use interrupt-driven features 
directly in those rare cases when the firmware cannot meet your needs. 


If you use interrupt hardware directly, instead of using the built-in 
interrupt-handling firmware, you can’t be sure that your programs will be 
compatible with possible future Apple II series computers or revisions. 


E.1 Introduction 


ee ee 
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This section describes interrupts and their effects on the Apple Ile 
hardware. 


E.1.1 What Is an Interrupt? 


An interrupt is a signal that a computer uses to know when to stop what it’s 
doing so it can quickly handle a time-dependent task. For example, the 
Apple IIc mouse sends an interrupt to the computer every time it moves. 
This lets the system keep track of the mouse’s position and maint ain 
smooth movement of the pointer on the screen. 


When an interrupt occurs, control passes to an interrupt handler, which 
must record the exact state of the computer at the moment of the interrupt, 
determine the source of the interrupt, and take appropriate action. It is 
important that the computer preserve a snapshot of its state when 
interrupted, so that when it continues later with what it was doing, those 
conditions can be restored. 


E.1.2 Interrupts on Apple Il Computers 
Se See ee eee eee eee eae 


Interrupts have not always been fully supported on the Apple II. All 
versions of Apple’s DOS, as well as the Monitor program, rely on the 
integrity of location $45, which the built-in interrupt handler has always 
destroyed by saving the accumulator in it. Most versions of Pascal simply do 
not work with interrupts enabled. 


The Apple [Ic built-in interrupt handler now saves the accumulator on the 
stack instead of in location $45. DOS 3.8, ProDOS, Pascal 1.2 (or later 
versions) and the Monitor all work with interrupts on the Apple IIc. 
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You should use either ProDOS or Pascal 1.2 (or later versions) if you want 
interrupt-using software to work on the Apple Ile and the Apple II Plus. 
Both operating systems have full interrupt support built in. 


Interrupts are effective only if they are enabled most of the time since 
interrupts that occur while interrupts are disabled cannot be detected. Due 
to the critical timing of disk read and write operations, Pascal, DOS 3.3, and 
ProDOS turn off interrupts while accessing the disk. Thus it is important to 
remember that while a disk drive is being accessed, all the interrupt sources 
discussed below are turned off. 


On the Apple Ile only, interrupts are periodically turned off while 80-column 
screen operations are being performed. This is most noticeable while the 
screen is scrolling. Also, most peripheral cards used in the Apple IIe disable 
interrupts while reading and writing. 


E.1.3 Interrupt Handling on the 65C02 


From the point of view of the 65C02, there are three possible causes of 
interrupts. 


1. The IRQ line on the microprocessor can be pulled low if 65C02 
interrupts are not masked (that is, the CLI instruction has been used). 
This is the standard technique that devices use when they need 
immediate attention. 


2. The processor executes a break (BRK, opcode $00) instruction. 


3. A nonmaskable interrupt (NMI) occurs. Because the NMI line in the 
Apple IIc’s 65C02 is not used, this never happens on the Apple Ilc. 


The first two possibilities cause the 65C02 to save the current program 
counter and status byte on the stack and then jump to the routine whose 
address is stored in $FFFE and $FFFF. The sequence performed by the 
65C02 is: 


1. Ifan IRQ occurs, finish executing the current instruction. (If a BRK 
occurs, the current instruction is already finished. ) 


. Push the high byte of the program counter onto stack. 

. Push the low byte of the program counter onto stack. 

. Push the program status byte onto stack. 

. Jump to the address stored in $FFFE, $F FFF—that is, JMP ($FFFE). 


The different sources of interrupt signals are discussed below. 


OU fm @ DO 
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E.1.4 The Interrupt Vector at $FFFE 


In the Apple IIc there are three separate regions of memory that contain 
address $FFFE: the built-in ROM, the bank-switched memory in main RAM, 
and the bank-switched memory in auxiliary RAM. The vector at SFFFE in 
the ROM points to Apple IIc’s built-in interrupt handling routine. ‘You should 
generally use the built-in interrupt handler, rather than writing your own, 
because of the complexity of interrupts on the Apple IIc. 


When you initialize the mouse or serial communication firmware, copies of 
the ROM’s interrupt vector are placed in the interrupt vector addresses in 
both main and auxiliary bank-switched memory. If you plan to us e 
interrupts and the bank-switched memory without the mouse or 
communication firmware, you must copy the ROM’s interrupt vector 
yourself. 


E.2 The Built-in Interrupt Handler 


ee 
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The built-in interrupt handler is responsible for determining whet_her a BRK 
or an IRQ interrupt occurred. If it was an IRQ interrupt, it decides whether 
the interrupt should be handled internally, handled by the user, or simply 
ignored. 


The built-in interrupt handling routine records the current memory 
configuration, then sets up its own standard memory configuratiom so that a 
user’s interrupt handler knows the precise memory configuration when it is 
called. 


Next the handler checks to see if the interrupt was caused by a break 
instruction, and if it was, handles it as described in Section E.4. 


If the interrupt was not caused by a BRK, the handler checks for interrupts 
that it knows how to handle (for example, a properly initialized mouse) and 
handles them. 


Depending on the state of the system, it either ignores other interrupts, or 
passes them to a user’s interrupt handling routine whose address is stored 
at $03FE and $08FF of main memory. 


After handling an interrupt itself, or after the user’s handler returns (with 
an RTI), the built-in interrupt handler restores the memory configuration, 
and then does an RT] to restore processing to where it was when tlhe 
interrupt occurred. Figure E-1 illustrates this whole process. Each of the 
steps is explained in detail in the sections that follow. 
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Figure E-1. Interrupt-Handling Sequence 


Interrupted Built-in User’s 
Program Processor Handler Handler 


Program —————* Push address 
Push status 
JMP ($FFFE) ——*™ Save old and set 
new memory 
configuration. 
If BRK then go to —_ WW 


break handler 
($FA47). 


Our interrupt? 


NO: 

Push address 

Push status 

JMP ($03FE) —— Handle interrupt. 


YES: 
Handle it. 


Restore memory “— RTI 
configuration. 


Pull status <———_ RTI 
Program “———_ Pull address 


E.2.1 Saving the Memory Configuration 


The built-in interrupt handler saves the state of the system, and sets it toa 
known state according to these rules: 


a If 80Store and Page2 are on, then it switches in text Page 1 (Page2 off) so 
that main screen holes are accessible. 


oO It switches in main memory for reading (RAMRd off). 

O It switches in main memory for writing (RAMWrt off). 

o It switches in ROM addresses $D000-$FFFF for reading (RdLCRAM off). 
O It switches in main stack and zero page (AItZP off). 

O 


It preserves the auxiliary stack pointer, and restores the main stack 
pointer (see Section E.2.2). 


O It preserves the current ROM state and switches in the ROM bank 1. 
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Note: Because main memory is switched in, all memory addresses used 
later in this appendix are in main memory unless otherwise specified. 


E.2.2 Managing Main and Auxiliary Stacks 
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Because the Apple IIc has two stack pages, the firmware has established a 
convention that allows the system to be run with two separate stack 
pointers. Two bytes in the auxiliary stack page are to be used as storage for 
inactive stack pointers: $0100 for the main stack pointer when the auxiliary 
stack is active, and $0101 for the auxiliary stack pointer when the main 
stack is active. 


When a program that uses interrupts switches in the auxiliary stack for the 
first time, it should place the value of the main stack pointer at auxiliary 
stack address $0100, and initialize the auxiliary stack pointer to $FF (the 
top of the stack). When it subsequently switches from one stack to the 
other, it should save the current stack pointer before loading the pointer for 
the other stack. 


When an interrupt occurs while the auxiliary stack is switched in, the 
current stack pointer is stored at $0101, and the main stack pointer is 
retrieved from $0100. Then the main stack is switched in for use. After the 
interrupt has been handled, the stack pointer is restored to its original 
value. 


E.3 User’s Interrupt Handler at $03FE 
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You can set up screen hole locations to indicate that the user’s interrupt 
handler should be called when certain interrupts occur. To do this, place 
your interrupt handler’s address at $03FE and $03FF in main memory, low 
byte first. 


The user’s interrupt handler should do the following: 


o Verify that the interrupt came from the expected source. The following 
sections describe how this should be done for each interrupt source. 


oO Handle the interrupt as desired. 


o Clear the interrupt, if necessary. The following sections describe how to 
clear the interrupts. 


oO Return with an RTI. 
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If your interrupt handler needs to know the memory configuration at the 
time of the interrupt, it can check the encoded byte stored four bytes down 
on the stack. This byte is explained in Section E.4. 


In general there is no guaranteed maximum response time for interrupts. 
This is because the system may be doing a disk operation, which could last 
for several seconds. 


Once the built-in interrupt handler has been called, it takes about 250 to 
300 microseconds for it to call your interrupt handling routine. After your 
routine returns, it takes 40 to 140 microseconds to restore memory and 
return to the interrupted program. 


If memory is in the standard state when the interrupt occurs, the total 
overhead for interrupt processing is about 150 microseconds less than if 
memory is in the worst possible state (80Store and Page2 on, auxiliary 
memory switched in for reading and writing, auxiliary bank-switched 
memory page $02 switched in for reading and writing). 


E.4 Handling Break Instructions 

I aa aaa ee aa aa ne ng gr 
After the interrupt handler has set the memory configuration, it checks to 
see if the interrupt was caused by a BRK (opcode $00) instruction. (If it 
was, bit 4 of the processor status byte is a 1.) If so, it jumps to a break 
handling routine, which saves the state of the computer at the time of the 


break as follows: 

Information Location 

Program counter (low byte) $3A 

Program counter (high byte) $3B 

Encoded memory state $44 

Accumulator $45 

X register $46 

Y register $47 

Status register $48 

Finally, the break routine jumps to the routine whose address is stored at 
$03F0 and $03F1. 

The encoded memory state in location $44 can be interpreted as follows: 
Bit 7 = 0 

Bit 6 = ] if 80Store and Page2 both on 
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Bit 5 = |] if auxiliary RAM switched in for reading 


Bit 4 = |] if auxiliary RAM switched in for writing 

Bit 8 = |] if bank-switched RAM being read 

Bit 2 = 1 __ ifbank-switched $D000 page $01 switched in 
Bit 1 = 1 __ ifbank-switched $D000 page $02 switched in 
Bit 0 = 
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The Apple IIc can receive interrupts from many different sources. Each 
source is enabled and used slightly differently from the others. There are 
two basic sources of interrupts: use of the mouse, and actions affecting the 
two 6551 ACIA circuits (the chips that control serial communication). How 
to use these sources of interrupts in conjunction with the built-in interrupt 
handler is discussed in Section E.6. 


Mouse use can cause interrupts when 


oO the mouse is moved in the horizontal (X) direction 
oO the mouse is moved in the vertical (Y) direction 
Oo the mouse button is pressed. 


Interrupts can also be generated every 1/60 second by the rising edge of the 
vertical blanking signal. This is called the vertical blanking (VBL ) interrupt, 
and is synchronized with a signal used for the video display. 


Actions affecting the ACIA circuits can cause interrupts when 


oO akey is pressed (the firmware can use this interrupt to buffer 
keystrokes, or it can pass the interrupt on to the user) 

o either ACIA has received a byte of data from its port (the firmware can 
use this interrupt to buffer data or it can pass the interrupt on to the 
user) 

O pin 6d of either serial port changes state (device ready /not ready to accept 
data) (when the serial firmware is active, this interrupt is absorbed; 
however, the serial firmware uses the signal to decide whether or not to 
transmit the next byte of data) 

o either ACIA is ready to accept another character to be transmitted (when 
the serial firmware is active, this interrupt is absorbed; however, the 
serial firmware uses the signal to decide whether or not to trarasmit the 
next byte of data) 
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o the keyboard strobe is cleared (the firmware absorbs this interrupt). 


An interrupt can also be generated by a device attached to the external disk 
drive port. The firmware can pass this interrupt cn to the user. 


E.6 Firmware Handling of Interrupts 
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The following sections discuss how the various sources of interrupts should 
be used together with the built-in interrupt handler. 


E.6.1 Firmware for Mouse and VBL 

SSSI ——————————E—————————————— eal 

As described in Chapter 9, the mouse can be initialized (by the SetMouse 
call) to nine different modes that enable one or more sources of interrupts. 
In transparent mode, the interrupts are entirely handled by the built-in 
interrupt handler; the other modes require a user-installed interrupt 
handler. 


When the mouse is initialized, the interrupt vector is copied to addresses 
$FFFE and $FFFF in main and auxiliary bank-switched RAM. This permits 
mouse interrupts with any memory configuration. 


When the mouse is active, possible sources of interrupts are those listed in 
Section E.5 as resulting from mouse use. 


When an interrupt occurs, the built-in interrupt handler determines 
whether that particular interrupt source was enabled (by the SetMouse 
call). If so, the user’s interrupt handler, whose address is stored at $03FE, is 
called. 


The user’s interrupt handler should first call ServeMouse to determine the 
source of the interrupt. This call updates the mouse status byte at $077C 
and returns with the carry bit clear if mouse movement, button, or vertical 
blanking was the source of the interrupt. 


The values of this mouse status byte at $077C are as follows: 


Bit 1 means that 

3 Interrupt was from vertical blanking 
2 Interrupt was from button 

] Interrupt was from mouse movement 
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If the interrupt was due to mouse movement or button, the user’s interrupt 
handler should then do a call to ReadMouse. This causes the mouse 
coordinates and status to be updated as follows: 


$047C Low byte of X coordinate 
$04FC Low byte of Y coordinate 
$057C High byte of X coordinate 
$05FC High byte of Y coordinate 
$077C Button and movement status 
Bit Means 
1 ( = button up; 1 = button down 
6 (. = button up on last ReadMouse 
1 = button down on last ReadMouse 
D () = no movement since last ReadMouse 


1 = movement since last ReadMouse 
3-1 Always set to 0 (interrupt cleared) 


After the interrupt has been handled, the routine should terminate with 
an RTI. 


Remember that interrupts may be missed during disk accesses. 


If you turn on mouse interrupts without initializing the mouse, the built-in 
interrupt handler will absorb the interrupts. If you want to handle mouse 
interrupts yourself, you must write your own interrupt handler and place 
vectors to it at addresses $FFFE and $FFFF in bank-switched RAM. 
Interrupts will be ignored whenever the $D000-$FFFF ROM is switched in. 


E.6.2 Firmware for Keyboard Interrupts 
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The Apple IIc hardware is able to generate an interrupt when a key is 
pressed. The firmware is able to buffer up to 128 keystrokes, completely 
transparently, when properly enabled to do so. It saves them in the second 
half of page $08 of auxiliary memory. After the buffer is full, subsequent 
keystrokes are ignored. Because interrupts are only generated when 
keypresses occur, characters generated by the auto-repeat feature are not 
buffered. They can, however, be read when the buffer is empty. 


Once keyboard buffering has been turned on, the next key should be read 
by calling RdKey ($FDOC). 
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AWarning 


Do not call the buffer reading routine directly. Its entry address will not 
be the same in future versions of the computer. 


The special characters (stop list) and (stop 
Applesoft execution) do not work while keyboard buffering is turned on. A 


new keystroke, (& }{ CONTROL }{ x], clears the buffer. 


Using Keyboard Buffering Firmware 


Keyboard buffering is automatically turned on when the serial firmware is 
placed in terminal mode. Otherwise you must turn it on yourself this way: 


1. 
2. 


3. 


Disable processor interrupts (SEI). 

Set location $05FA to $80. This tells the firmware to buffer keystrokes 
without calling the user’s interrupt handler. 

Set locations $05FF and $06FF to $80. These are pointers to where in 
the buffer the next keystroke will be stored and where the next will be 
read from, respectively. 


. Turn on the ACIA for port 2 by setting the low nibble of $COAA to the 


value $0F. For example: 


LDA $CBAA Read port 2 ACIA command register 
ORA #$0F Set low nibble to $0F 
STA $CBAA Set port 2 ACIA command register 


If you are using the serial ports at the same time, just set the low bit of 
$COAA to 1. This prevents receiver interrupts from being turned off. 


A PR#2 or IN#2 or the equivalent will shut off keyboard interrupts. 


. Enable processor interrupts (CLI). 


Using Keyboard Interrupts Through Firmware 


Keyboard interrupts are received through the ACIA for port 2. They can be 
enabled as follows: 


l. 
2. 


3. 


Disable processor interrupts (SEI). 
Set location $05FA to $C0. This tells the firmware to identify a 
keystroke interrupt, and to call the user’s interrupt handler. 


Turn on the ACIA for port 2 by setting the low nibble of $COAA to the 
value $0F. For example: 


LDA $CBAA Read port 2 ACIA command register 
ORA #$OF Set low nibble to $0F 
STA $CBAA Set port 2 ACIA command register 


. Enable processor interrupts (CLI). 
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When the user’s interrupt handler is called, it can identify the keyboard as 
the interrupt source by reading location $04FA. This is a copy of the ACIA 
status register at the time of the interrupt. If the interrupt was due to 
something on the ACIA for port 2, bit 7 is set. If the interrupt was caused by 
a keystroke, bit 6 is set and bit 5 is unchanged. 


After servicing this interrupt, the interrupt handler should clear the 
interrupt by setting $04F'A to $00. 


E.6.3 Using External Interrupts Through Firmware 
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Pin 9 of the external disk drive connector (EXTINT) can be used. to generate 
interrupts through the ACIA for port 1. It can be used as a source of 
interrupts (on a high-to-low transition) if enabled as follows: 


1. Disable processor interrupts (SEI). 

2. Set location $05F9 to $CO0. This tells the firmware to identify an external 
interrupt, and to call the user’s interrupt handler. 

3. Turn on the ACIA for port 1 by setting the low nibble of $CO9A to the 
value $0F. For example: 


LDA $CB89A Read port 1 ACIA command register 
ORA #$OF Set low nibble to $0F 
STA $CO9A Set port 1 ACIA command register 


4. Enable processor interrupts (CLI). 


When the user’s interrupt handler is called, it can identify this interrupt by 

reading location $04F9. This is a copy of the ACIA status register at the time 
of the interrupt. If the interrupt was due to something on the ACIA for 

port 1, bit 7 is set. If the interrupt was caused by the external interrupt line, 
bit 6 is clear and bit 5 is unchanged. 


After servicing this interrupt, the interrupt handler should clear the 
interrupt by setting $04F9 to $00. 


E.6.4 Firmware for Serial Interrupts 
ee a ee) 


The Apple IIc hardware is able to generate interrupts both when the ACIA 
receives data and when it is ready to send data. The built-in interrupt 
handler responds to incoming data only. The firmware is able to buffer up to 
128 incoming bytes of serial data from either serial port. After the buffer is 
full, data are ignored. Only one port can be buffered at a time. The following 
sections assume that the serial port to be buffered is already initi alized, as 
explained in Chapter 8. 
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Using Serial Buffering Transparently 


Serial buffering is automatically turned on when the serial firmware is 
placed in terminal mode. Otherwise you must turn it on yourself, as follows: 


1. Disable processor interrupts (SEI). 

2. Set location $04FF to $C1 to buffer port 1, or to $C2 to buffer port 2. 

3. Set locations $057F and $067F to $00. These are pointers to the next 
byte in the buffer to be used and the next character to be read from the 
buffer, respectively. 


4. Turn on the ACIA for the port by setting the low nibble of $CO9A for 
port 1 or $COAA for port 2 to $0D. For example: 


LDA $CO9A Read port 1 ACIA command register 


AND $F@ Clear low nibble 
ORA #$@D Set low nibble to $0D 
STA $CO9A Set port 1 ACIA command register 


The 0 in bit 1 of the command register enables receiver interrupts; thus 
an interrupt is generated when a byte of data is received. 


5. Enable processor interrupts (CLI). 


When serial port buffering is thus enabled, normal reads from the serial port 
firmware fetch data from the buffer rather than directly from the ACIA. 


Using Serial Interrupts Through Firmware 


It is also possible to use the firmware to call the user interrupt handler 
whenever a byte of data is read by the ACIA. In this mode buffering is not 
performed by the firmware. 


1. Disable processor interrupts (SEI). 
2. Set location $04FF to a value other than $C1 or $C2. 


3. Turnon the ACIA for the port by setting the low nibble of $C09A for 
port 1 or $COAA for port 2 to $0D. For example: 


LDA $CO9A Read port 1 ACIA command register 
AND $F@ Clear low nibble 

ORA #$8D Set low nibble to $0D 

STA $CO9A Set port 1 ACIA command register 


The 0 in bit 1 of the command register enables receiver interrupts; thus 
an interrupt is generated when a byte of data is received. 


4. Enable processor interrupts (CLI). 
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When a Serial port is thus enabled, the user’s interrupt handler is called 
each time the port receives a byte of data. The status byte saved by the 
firmware ($04F9 for port 1; $04FA for port 2) has the high bit set if the 
interrupt occurred on that port. Bit 3 is set if the interrupt was due to a 
received byte of data. 


The interrupt handler should clear the interrupt by clearing bits 7 and 3 of 
that port’s status byte ($04F9 for port 1; $04FA for port 2). 


Transmitting Serial Data 


The serial firmware does not implement buffering for serial output. Instead 
it waits for two conditions to be true before transmitting a character: 


Oo The ACIA’s transmit register must be ready to accept a character. This is 
true if bit 4 of the ACIA’s status register is 1. 


oO The device must signal that it is ready to accept data. This is true if bit 5 
of the ACIA’s status register is 0. Bit 5 is 0 if pin 5 of the port’s connector 
is also 0. 


When the serial firmware is active, a change of state on pin 5 of that port 
generates an interrupt. That interrupt is absorbed, but the data remain in 
bit 5 of the status register. Interrupts from the ACIA’s transmit register are 
normally disabled. 


A Loophole in the Firmware 


So that programs can make use of interrupts on the ACIAs without affecting 
mouse interrupt handling, there is a tiny loophole purposely left in the 
built-in interrupt handler. If transmit interrupts are enabled on the ACIA— 
that is, if bits 3, 2, and 0 of the ACIA’s command register have the values 0, 
1, and 1, respectively—then control is passed to the user’s interrupt handler 
if the interrupt is not intended for the mouse (movement, button, or VBL). 


This means that you can write more sophisticated serial interrupt handling 
routines than the limited firmware space could provide (such as printer 
spooling). The firmware will still set memory to its standard state, handle 
mouse interrupts, and restore memory after your routine is finished. 


When you receive the interrupt, neither ACIA’s status register has been 
read. You are fully responsible for checking for interrupts on both ACIAs, 
determining which of the four interrupt sources on each ACIA caused the 
interrupt, and how to handle them. Refer to the 6551 specification for more 
details. The built-in firmware itself is an excellent example of how 
interrupts on the ACIA can be handled. 
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E.7 Bypassing the Interrupt Firmware 
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The following sections give further details on using interrupts on the 
Apple IIc computer without using the built-in interrupt handler. 


A method of handling mouse interrupts directly is described in Chapter 9. 


E.7.1 Using Mouse Interrupts Without the Firmware 
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To use mouse interrupts without the firmware, as mentioned above, you 
must set your own interrupt vectors. If the $D000-$FFFF ROM is ever 
switched in, the built-in interrupt handler will absorb the mouse interrupts. 


Tables E-1 and E-2 show how to activate and read mouse interrupts without 
using the firmware. Remember to disable interrupts (SEI) before enabling 
mouse interrupts, then turn them on when done (CLI). 


Table E-1. Activating Mouse Interrupts 


To Activate 
Interrupts On 


Mouse X 
(rising edge) 


Mouse X 
(falling edge) 


Mouse Y 
(rising edge) 


Mouse Y 
(falling edge) 


VBL 
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Enable IOU 
Access 

STA $C079 
STA $C079 
STA $C079 


STA $C079 


STA $C079 


Select 
Source 
STA $CO5C 
STA $C05D 
STA $CO5E 


STA $CO5F 


Enable 
Source 
STA $C059 
STA $C059 
STA $C059 


STA $C059 


STA $C05B 


Disable 

IOU Access 
STA $0078 
STA $C078 
STA $C078 


STA $0078 


STA $C078 


383 
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Table E-2. Reading Mouse Interrupts 


To Read Read Direction Determine Handle 

Interrupts From (A.S.A.P.) Source It Return 

Mouse X LDA $C066 LDA $C015 RTI 
(bit 7=1 if true) 

Mouse Y LDA $C067 LDA $C017 RTI 
(bit 7=1 if true) 

VBL LDA $C019 RTI 


(bit 7=1 if true) 


The mouse direction data read from $C066 and $C067 are guaranteed valid 
for at least 40 microseconds, and average duration is at least 
200 microseconds, so you should read the direction as soon as possible. 


E.7.2 Using ACIA Interrupts Without the Firmware 
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To use ACIA interrupts without the firmware, you must set your own 
interrupt vectors. If the $D000-$FFFF ROM is ever switched in, the built-in 
interrupt handler will handle the interrupt as determined by certain mode 
bytes (Section E.6.1). 


When writing your serial interrupt handler, refer to Figures 11-31 
through 11-33 and to the Synertek 6551 ACIA specification. As shown in 
Chapter 11, the ACIAs have the following connections: 


Port 1: DSR line connected to the EXTINT line on the 
external disk port. 


DCD line connected to pin 5 of port 1 connector. 


Port 2: DSR line goes high when a key is pressed. 
DCD line connected to pin 5 of port 2 connector. 


The ACIA registers have the following addresses: 


Port 1: Port 2: 

Data register = $C098 Data register = $COA8 
Status register = $C099 Status register = $COA9 
Command register = $CO9A Command register= $COAA 
Control register = $CO9B Control register = $COAB 
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This appendix compares the Apple IIc to the Apple Ile, Apple II Plus, and 
Apple II. It does not contain an exhaustive list of differences, but it does 
mention those differences most likely to affect the accuracy of programs, 
displays, and instructions created for end users of two or more A_pple II 
series models. 


F.1 Overview 


ee el 
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The differences between the Apple II series computers can be expressed as 
a series of equations: this computer equals that one plus or minus certain 
features. 


Note: The following equations compare each model of Apple [I series 
with its predecessor in terms of functional equivalence, not literal 
equality. For example, 


Apple II Plus = Apple II — Integer BASIC firmware 


does not mean that Integer BASIC firmware can be removed from the 
Apple II—just that the one machine functions as if it were the other 
without such firmware. 


Apple ITI Plus II + Autostart ROM 
+  Applesoft firmware 
+ 


48K RAM standard 


— old Monitor ROM 
— Integer BASIC firmware 
IT Plus + Apple Language Card (with 16K of 
RAM) 


+ 80-column (enhanced) video 
firmware 


built-in diagnostics 

full ASCII keyboard 

internal power light 

FCC approval 

improved back panel 

9-pin back panel game connector 
auxiliary slot (with possibil ity of 
80-column text card and ex tra 64K 
RAM) 


Apple Ile 


++++4+4+ +4 
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Apple IIc 


F.1.1 Type of Processor 
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Ile 
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Slot 0 


interrupt support in firmware 
(enhanced Ile) 


Mini-Assembler in firmware 
(enhanced Ile) 


extended 80-column text card 
80/40 switch 

keyboard switch 

disk-use light 

disk controller port 

disk drive 

mouse port 

serial printer port 

serial communication port 
built-in port firmware 
video expansion connector 


removable cover 

Slots 1 to 7 

auxiliary slot 

internal power light 
cassette I/O connectors 


internal game I/O connector (hence 
no game output) 


auxiliary video pin 
Monitor cassette support 


Mini-Assembler in firmware (IIc with 
UniDisk 3.5 support) 


Protocol Converter in firmware (IIc 
with UniDisk 3.5 support) 


The processor in the Apple II and II Plus is the 6502. The original Apple Ile 
uses a 6502A. The Apple IIc and enhanced Apple Ile both use the 65C02: 
this is a redesigned CMOS CPU that has 27 new instructions, new 
addressing modes, and for some instructions a differing execution scheme 
and machine cycle counts (see Appendix A). 
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Programs written for the Apple IIc will run on the earlier machines only if 
they do not contain instructions unique to the 65C02, or depend on shared 
instructions whose cycle times differ. Programs should also use only 
published entry points in the Monitor firmware to allow maximum 
compatibility between different Apple II series computers. 


F.1.2 Machine Identification 
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Identification of Apple II series computers is as shown in Table F-1. 


Table F-1. Apple II Series Identification Bytes 


Machine $FBB3 $SFBIE SFBCO $FBBF 
Apple II $38 
Apple II Plus $EA $AD 
Apple Ile $06 SEA 
Apple Ile (enhanced) $06 $E0 
Apple IIc $06 $00 $FF 
Apple IIc (UniDisk 3.5 support) $06 $00 $00 
Apple III in Apple I] 

emulation mode $EA $8A 


Any future Apple II series computer or ROM release will have different 
values in these locations. Machine identification routines are available from 
Apple Vendor Technical Support. 


The MachID byte for ProDOS ($BF98 on the global page) will have bit 3 set 
to 0 if the computer is an Apple II, II Plus, IIe, or III, and to 1 if the computer 
is not one of these machines. In an Apple IIc, bits 7 and 6 are also set to 
binary 10. 


Bits 7 and 6 set to binary 10 indicate that a computer is Apple Ile and IIc 
compatible, regardless of the value of bit 3. 
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This section compares the memory organization of the Apple IIc with that of 
the Apple II, I] Plus, and Ile. These machines differ in RAM space, ROM 
space, slot or port address space, and hardware page use. 


Appendix F: Apple II Series Differences 


F.2.1 Amount and Address Ranges of RAM 
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The Apple II could have as little as 4K of RAM at the time of purchase, and 
could be upgraded to as much as 48K of RAM, following a procedure 
described in the Apple IJ Reference Manual. 


The Apple II Plus has 48K of RAM ($0000 through $BFFF) as a standard 
feature. With the addition of an Apple Language Card, a 48K Apple II or 
II Plus could be expanded to have 64K of RAM. 


The Apple Ile has a full 64K of RAM. The top 12K addresses overlap with 
the ROM addresses $D000 through $FFFF. There is an additional 
bank-switched area of 4K from $D000 through $DFFF. This arrangement is 
equivalent to an Apple II Plus with an Apple Language Card installed. A 
program selects between the RAM and ROM address spaces and between 
the $Dxxx banks by changing soft switches located in memory. 


With an Extended 80-Column Text Card installed in its auxiliary slot, an 
Apple Ife has an additional 64K of RAM available, although no more than 
half of the 128K of RAM space is available at any given time. Soft switches 
located in memory control these address space selections. 


The RAM in the Apple IIc is equivalent to the RAM in an Apple Ile with an 
Extended 80-Column Card. 


F.2.2 Amount and Address Ranges of ROM 


The Apple II has 8K of ROM ($E000 through $FFFF), and the Apple II Plus 
has 12K of ROM ($D000 through $FFFF). Users can plug their own ROMs 
into the sockets provided. The on-board (as opposed to slot) ROM address 
range is from $D000 through $FFFF. 


The Apple IIe has 16K of ROM, of which it uses 15.75 K (addresses $C100 
through $FFFF; page $CO addresses are for I/O hardware). ROM addresses 
$0300 through $C3FF (normally assigned to the ROM in a card in slot 3) and 
$C800 through $CFFF contain 80-column video firmware; ROM addresses 
$C100 through $C2FF and $C400 through $C7FF (normally assigned to the 
ROM on cards in slots 1, 2, 4, 5, 6, and 7) contain built-in self-test routines. 


A soft switch in RAM controls whether the video firmware or slot 3 card 


ROM is active. Invoking the self-tests with causes 
the self-test firmware to take over the slot ROM address spaces. 
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UniDisk 3.5 


The Apple IIc ROM also uses the 15.75 K from $C100 through $F FFF, and its 
enhanced video firmware has the same entry point addresses as on the 
Apple Ile. However, there are only rudimentary built-in self-tests, and these 
do not preempt any port firmware space. 


The Apple IIc with built-in UniDisk 3.5 support has twice the ROM (82K) 
of the original Apple IIc. The extra ROM contains support for the Protocol 
Converter, a Mini-Assembler, STEP and TRACE functions in the Monitor 
firmware, expanded self-test routines, and improved interrupt support. 


In the Apple IIc, addresses $C100 through $CFFF contain I/O and interrupt 
firmware, addresses $D000 through $F7FF contain the Applesoft BASIC 
interpreter, and addresses $F800 through $FFFF contain the Monitor. 


F.2.3 Peripheral-Card Memory Spaces 


Each Apple IIc port has up to 16 peripheral-card I/O space locations in main 
memory on the hardware page (beginning at location $C0s0 + $80 for slot or 
port s), allocated in the standard Apple II series way (that is, beginning at 
location $C0s0 + $80 for each slot s). 


The peripheral-card ROM space (page $Cs for slot s in the Apple II, II Plus, 
and Ile) contains the starting and entry-point addresses for port s, but port 
routines are not limited to their allocated $Cs pages. 


The 2K-byte expansion ROM space from $C800 to $CFFF in the Apple IIc is 
used by the enhanced video firmware and miscellaneous I/O and 
memory-transfer routines. 


The 128 bytes of peripheral-card RAM space (or scratch-pad RAM) 

(64 screen holes in main memory and their equivalent addresses in 
auxiliary memory) are reserved for use by the built-in firmware. It is 
extremely important for the correct operation of Apple IIc firmware that 
these locations not be altered by software except for the specific purposes 
described in Chapters 7, 8, and 9, and in Appendix E. 


F.2.4 Hardware Addresses 
ee eee ee 


The hardware page (the addresses from $C000 through $COFF) controls 
memory selection and input/output hardware characteristics. All input and 
output (except video output) takes place at one or more hardware page 
addresses. For the sake of simplicity, this section presents only a general 
comparison between the Apple IIc on the one hand, and the Apple II, II Plus, 
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and Ile on the other, with respect to hardware page use. However, for many 
characteristics, the Apple Ile and IIc work one way, while the Apple II and 
II Plus work another. 


$C000-$COOF 


On all Apple II series computers, reading any one of these addresses reads 
the keyboard data and strobe. On the Apple Ile and IIc, writing to each of 
these addresses turns memory and display switches on and off. Writing to 
addresses $C006, $C007, $COOA, and $CO0B performs ROM selection on the 
Apple Ile. Writing to these four addresses is reserved on the Apple IIc. 


For reading the keyboard, use $C000; reserve $C001 through $COO0F. 


$C010-$C01F 


On all Apple II series computers, writing to any one of these addresses 
clears the keyboard strobe. On the Apple Ile and IIc, reading each of these 
addresses checks the status of a memory or display switch, or the 
any-key-down flag. 


For clearing the keyboard strobe, use $C010; reserve $C011 through $COI1F. 
Reading $C015 checks the SLOTCXROM switch on the Apple Ile, but it 
resets the X-movement interrupt (XInt) on the Apple IIc. Similarly, reading 


$C017 checks the SLOTC3ROM switch on the Apple Ile, but it resets the 
Y-movement interrupt (YInt) on the Apple IIc. 


Reading $C019 checks the current state of vertical blanking (VBL) on the 
Apple Ile, but it resets the latched vertical blanking interrupt (VBlInt) on 
the Apple IIc. 


$C020-$C02F 


On the Apple II, II Plus, and Ile, reading any address $C02x toggles the 
cassette output signal. On the original Apple IIc, both reading from and 
writing to these locations are reserved. The Apple IIc with 32K of ROM uses 
$C028 to switch in or out the extra 16K of ROM. 


$C030-$CO03F 


On all Apple II series computers, reading an address of the form $C08x 
toggles the speaker. For full Apple II series compatibility, toggle the speaker 
using $C030, and reserve $C031 through $CO8F. 


On the Apple IIc, writing to $C031 through $C08F is explicitly reserved. 
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$C040-$C04F 


On the Apple II, II Plus, and Ile, reading any address of the form $C04x 
triggers the utility strobe. The Apple IIc has no utility strobe. 


On the Apple IIc, addresses $C044 through $C047 are explicitly reserved, 
and reading or writing any address from $C048 through $C04F resets both 
the X and Y mouse interrupts (XInt and YInt). 


$C050-$CO5F 


Addresses $C050 through $C057 work the same on the Apple IIc as on the 
Apple Ile: they turn the TEXT, MIXED, Page2, and HiRes switches on and 
off. 


On the Apple Ile, addresses $C058 through $CO5F turn the annunciator 
outputs on and off. On an Apple Ile with a revision B main logic board or 
later, an Apple Extended 80-Column Text Card, and a jumper installed on 
the card, reading locations $CO5E and $CO5F set and clear 
double-high-resolution display mode. 


On the Apple llc, if the IOUDis switch is on, both reading from and writing 
to addresses $C058 through $CO5D are reserved, and addresses $CO5E and 
$CO5F set and clear the double-high-resolution display (as on the Apple Ile 
equipped as described in the preceding paragraph). If the IOUDis switch is 
off, then addresses $C058 through $C05F control various characteristics of 
mouse and vertical blanking interrupts (Table 9-2). 


$C060-$CO6F 


On the Apple IIc, writing to any address of the form $C06x is reserved, and 
reading addresses $C068 through $CO6F is reserved. 


Reading addresses $C061 and $C062 is the same as on the Apple Ile (switch 
inputs and Apple keys). Reading addresses $C064 and $C065 is the same as 
on all other Apple II series computers (analog inputs 0 and 1). 


On the Apple IIc, address $C063 bit 7 is 1 if the mouse switch is not pressed, 
and 0 if it is pressed, so that software looking for the shift-key mod (used on 
Apple II, II Plus, and Ile with some text cards) will find it and display 
lowercase correctly. If by chance the mouse button is pressed when the 
software checks location $C068, it will appear that the shift-key mod is not 
present. 


On the Apple IIc, address $C060 is used for reading the state of the 
80/40 switch; on the Apple II, II Plus, and IIe, this address is for reading 
cassette input. 
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The Apple IIc has two, rather than four, analog (paddle) inputs. Addresses 
$C066 and $C067 are used for reading the mouse X and Y direction bits. 


$C070-$C07F 


On the Apple II, If Plus, and Ile, reading from or writing to any address of 
the form $C07x triggers the (analog input) paddle timers. 


On the Apple IIc, only address $C070 is to be used for that one function. 
Addresses $C071 through $C07D are explicitly reserved. The results of 
reading from or writing to addresses $CO7E and $CO7F are described in 
Table 5-8. 


$C080-SCO8F 


On the Apple Ile and IIc, accessing addresses in this range selects different 
combinations of bank-switched memory banks. However, addresses $C084 
through $C087 duplicate the functions of the four addresses preceding 
them, and addresses $C08C through $CO8F do also. These eight addresses 
are explicitly reserved on the Apple IIc. 


$C090-$COFF 


On the Apple II, I] Plus, and Ile, each group of 16 addresses of the form 
$C080 + $s0 is allocated to an interface card (if present) in slot s. 


On the Apple IIc, addresses corresponding to slots 1, 2, 3, 4, and 6 are 
allocated to a serial interface card, communication interface card, 
80-column text card, mouse interface card, and disk controller card, 
respectively. All other addresses in this range are reserved. 


F.2.5 Monitors 


SSS Se eed 

The older models of the Apple II and Apple II Plus included a different 
version of the System Monitor from the one built into more recent models 
(and the Apple Ile and IIc). The older version, called the Monitor ROM, had 
the same standard I/O subroutines as the newer Autostart ROM, but a few 
of their features were different; for example, there were no arrow keys for 
vertical cursor motion. 
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When you start the Apple IIc with a DOS or BASICS disk and it loads 
Integer BASIC into the bank-switched area in RAM, it loads the old Monitor 
along with it. When you type nT from Applesoft to activate Integer BASIC, 
you also activate this copy of the old Monitor, which remains active until 
you either type FP to switch back to Applesoft, which uses the new Monitor 
in ROM, or activate the 80-column firmware. 


F.3 1/0 in General 
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Apple IIc I/O is different from I/O on the Apple II, II Plus, and Ile in three 
important respects: the possibility of direct memory access (DMA) 
transfers, the presence or absence of slots, and the presence or absence of 
built-in interrupt handling. 


F.3.1 DMA Transfers 


SSSaSaSa__======SS=sr 

The Apple II, II Plus, and Ile allow DMA transfers, because both the address 
and the data bus are available at the slots. No true DMA transfer is possible 

with the Apple IIc because neither bus is available at any of the back panel 

connectors. 


F.3.2 Slots Versus Ports 


Saas ee ee ee 

The Apple II and II Plus have eight identical slots; the Apple Ile as seven 
identical slots plus a 60-pin auxiliary slot for video, add-on memory, and test 
cards. The Apple IIc has no slots; instead, it has back panel connectors and 
built-in hardware and firmware that are functional equivalents of slots with 
cards in them. The back panel connectors are called ports on the Apple IIc. 


F.3.3 Interrupts 


———————————————— as 

The Apple IIc is the first computer in the Apple II series to have built-in 
interrupt-handling capabilities. The enhanced Apple Ile has very similar 
interrupt-handling capability included. 
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F.4 Keyboard 

a 2 a i ee er ae Eee | 
Both keyboard layout and character sets vary in the Apple II series 
computers. The major keyboard difference in the Apple II series is that the 
Apple Ile and IIc have full ASCII keyboards, while the Apple II and II Plus 
do not. 


F.4.1 Keys, Switches, and Lights 


SSS SS SSS SS SSS Se) 

The Apple II and II Plus have identical 52-key keyboards. The Apple Ile and 
Apple IIc keyboards have the same 63-key full ASCII keyboard layout, with 
new and repositioned keys and characters as compared to the Apple II and 
II Plus. While the Apple II and II Plus have a key, the Ile and IIc have 
an auto-repeat feature built into each character key. 


Some Apple II and Apple II Plus machines have a slide switch inside the 
case, under the keyboard edge of the cover, for selecting whether or not 
works without (CONTROL }. On the Apple Ile and Apple IIc, there is 
no choice: works, and alone does not. 


The Apple IIc and Ile have an (G) and a[@] Key; the Apple II and II Plus do 
not have these two keys. 


The captions on several keys—{ESCAPE ], [TAB], [CONTROL ], [SHIFT ], 

[CAPS LOCK], (DELETE ], (RETURN), and (RESET }—can vary: on the Apple II 
and II Plus some are abbreviated or missing; on the Apple IIc all keycaps are 
lowercase italic; on international models, some captions are replaced by 
symbols (Appendix G). 


The Apple IIc has two switches that the other models do not have. One 
switch is for changing between 40-column and 80-column display; the other 
is for selecting keyboard layout (Sholes versus Dvorak on USA models) or 
both keyboard layout and character set (on international models). 


The position of the power-on light differs on the Apple II and II Plus, 
Apple Ile, and Apple IIc. The Apple IIc has a disk-use light as well. 


F.4.2 Character Sets 


ae ee ee 
The Apple II and II Plus keyboard character sets are the same. They are 
described in the Apple II Reference Manual. 
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The Apple Ile and Apple IIc keyboard character sets are the same: full 
ASCII. The standard (Sholes) layout and key assignments are described in 
the Apple Ile Technical Reference Manual. The Dvorak layout and key 
assignments are described in Chapter 4 and Appendix G of this manual. 


To change between the two available keyboard layouts requires 
modification to the main logic board on the Apple IIe, but only toggling of 
the keyboard switch on the Apple Ilc. 


Apple Computer, Inc. manufactures fully localized models (with regard to 
power supply and character sets) of both the Apple Ile and the Apple IIc. 
However, there are minor variations in keyboard layout, even among early 
and late production models of the same machine. For further details, refer 
to Appendix G of this manual. 


F.5 Speaker 

SE mT 0 ee SE) 
The Apple IIc has two speaker features that the three previous models do 
not have. They are a two-channel, but monaural, audio output jack for 
headphones—which disconnects the internal speaker when something is 
plugged into it—and a volume control. 


F.6 Video Display 

ee gg eee 
This section discusses the general differences between Apple IIc video 
display capabilities and those of the other computers in the series. Note, 
however, that as new ROMs become available for the Apple Ile, many 
differences between these two machines will vanish. 


F.6.1 Character Sets 
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The Apple II and II Plus display only uppercase characters, but they display 
them in three ways: normal, inverse, and flashing. The Apple IIc and Ile can 
display uppercase characters in all three ways, and they can display 
lowercase characters in the normal way. This combination is called the 
primary character set. 
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The Apple IIc and Ile have another character set, called the alternate 
character set, that displays a full set of normal and inverse uppercase and 
lowercase characters, but can’t display flashing characters. The primary 
and alternate character sets are described in Chapter 5. You can switch 
character sets at any time by means of the AltChar soft switch, also 
described in Chapter 5. 


Flashing display must not be used with the enhanced video firmware 
active. Use it in 40-column mode with the enhanced video firmware turned 
off; otherwise, strange displays may result, such as MouseText characters 
appearing in place of uppercase letters. 


To be sure of compatibility with some software, you have to switch the 
Apple IIc keyboard to uppercase by pressing [CAPS LOCK]. 


F.6.2 MouseText 


MouseText characters (Chapter 5) are available on every Apple IIc, and on 
the enhanced Apple IIe. 


F.6.3 Vertical Blanking 
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A signal called vertical blanking indicates when a display device should 
stop projecting dots until the display mechanism returns from the bottom of 
the screen to the top to make another pass. During this interval, a program 
can make changes to display memory pages, and thus provide a smooth, 
flicker-free transition to a new display. 


On the Apple Ile, vertical blanking (VBL) is a signal whose level must be 
polled. (VBL is not available to software on the Apple II or II Plus.) On the 
Apple IIc, vertical blanking is an interrupt (VBlInt) that occurs on the 
trailing edge of the active-low VBL signal. Programs intended to run on all 
Apple II series computers must take this difference into account. 


F.6.4 Display Modes 
ae ee ee 


All models have 40-column text mode, low-resolution graphics mode, 
high-resolution graphics mode, and mixed graphics and text modes. The 
Apple Ile (revision B motherboard) with an Apple Extended 80-Column 
Text Card, and the Apple IIc have double-high-resolution graphics mode 
also. 
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F.7 Disk I/O 


UniDisk 3.5 


The Apple II, If Plus, and Ile can support up to six disk drives (although four 
is the recommended maximum) attached in controller cards plugged into 
slots 6, 5, and 4. The Apple IIc supports up to two disk drives: its built-in 
drive (treated as slot 6, drive 1), and one external disk drive (treated as 

slot 6, drive 2; also treated as slot 7, drive 1 under ProDOS) for 

external-drive startup purposes. 


The Apple IIc with UniDisk 38.5 support does not use slot 7, drive 1 for 
external drives. They are handled through the Protocol Converter 
described in Chapter 6. The firmware for slot 7 ($C7xx) is needed for 
other parts of the firmware. 


F.8 Serial 1/O 
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The Apple IIc serial ports (ports 1 and 2) are similar to Super Serial Cards 
installed in slots 1 and 2 of an Apple Ile. The serial port commands are a 
slightly modified subset of Super Serial Card commands. This subset 
includes all the commands supported by the earlier Apple Serial Interface 
Card and Communication Card. 


F.8.1 Serial Ports Versus Serial Cards 


There are several important differences between Apple IIc serial ports and 
other Apple II series computers with serial cards installed in them. 


Apple IIc serial ports have no switches. Instead, initial values are moved 
from firmware locations into auxiliary memory when the power is turned 
on. Changes made to these values in auxiliary memory remain in effect 


until the power is turned off. Pressing does not 
change them. 


When the port itself is turned on (with an IN or PR command), the initial 
values in auxiliary memory are placed in the main memory screem holes 
assigned to the port. These characteristics can be changed by the port 
commands. The changed characteristics remain in effect until the port is 
turned off and then on again (with PR and IN commands). 
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UniDisk 3.5 


The command syntax for the Apple IIc ports also differs from the syntax for 
serial cards. A separate command character, CONTROL-A or CONTROL-I, 
must precede each individual port command, whereas several commands to 
a serial card can be strung together between the command character and a 
carriage return character. 


The letters used for some of the commands have been changed from those 
used with the Super Serial Card (such as S instead of B for sending a 
BREAK signal). Each serial port command letter is unique, to simplify 
command interpretation. 


Changing the command character from CONTROL-A to CONTROL-I, or vice 
versa, makes the Super Serial Card change from communication mode to 
printer mode and back; this is not the case with Apple IIc serial ports. With 
the Apple IIc, use the System Utilities disk to change modes. 


Super Serial Card commands support some functions that Apple IIc serial 
port commands don’t support: translating incoming characters, such as 
changing lowercase to uppercase (for the benefit of the Apple II or II Plus); 
delaying after sending carriage return, line feed, or form feed, and so on. 


Several new serial port commands are available on the Apple IIc with 
UniDisk 3.5 support. These commands have been added to make it easier 
to write programs for the IIc that are also compatible with the Super 
Serial Card. See Chapters 7 and 8 for these new commands. 


Following a CONTROL-I nnnN command, the Apple IIc automatically 
generates a carriage return after nnnN characters; with the Super Serial 
Card, you need to turn this on with CONTROL-I C. 


F.8.2 Serial |/O Buffers 
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The communication port firmware uses auxiliary memory page $08 as an 
input and output buffer. By doing so, the firmware can keep up with higher 
baud rates. It can also hide data from the Monitor, Applesoft, and other 
system software. 


Programs written for the Apple Ile or IIc can, of course, store information in 
auxiliary memory page $08. However, such information is destroyed when 
the communication port is activated. 
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F.9 Mouse and Hand Controllers 
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The DB-9 back panel connector on the Apple IIc is used for both the mouse 
and hand controllers. On the Apple Ile, the DB-9 connector supports hand 
controllers only; the mouse must use the connector on the interface card. 


F.9.1 Mouse Input 


Sear ee ae ee) 

The Apple IIc provides built-in firmware support for a mouse connected to 
the DB-9 mouse and hand controller connector. Apple IIc mouse support 
includes mouse movement and button interrupts (and vertical blanking 
interrupts for synchronization with the display); Apple Ile mouse support 
relies on polling VBL instead of vertical blanking interrupts. 


As a result of how interrupts are handled on the two machines, the mouse 
firmware routine calls function somewhat differently for the Apple IIc and 
Apple Ile. However, using the calls in the manner described in Chapter 9 
insures mouse support compatibility between the two machines. 


The ratio of mouse movement to cursor movement is different on the 
Apple IIc from on the Apple Ile. 


F.9.2 Hand Controller Input and Output 
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The Apple II, II Plus, and Ile have a 16-pin game I/O connector inside the 
case that supports three switch inputs, four analog (paddle) inputs, and four 
annunciator outputs. The Apple [le and Apple IIc have a DB-9 back panel 
connector that supports the three switch inputs and two paddle inputs (plus 
two more on the internal GAME I/O connector of the Apple II, I] Plus, 

and Ile). 


The Apple IIc does not support the four annunciator outputs. 


The characteristic response curve for hand controllers differs for the 

Apple IIc from that of the Apple II, II Plus, and Ile. Compare Figure F-1 with 
Figure 11-42. This was done so the hardware would support identifiable 
mouse and hand controller signals using the same circuits. 


The paddle timing circuit on the Apple II Plus is slightly different from the 
one on the Apple Ile and IIc. On the Apple Ile and IIc the 100-ohm fixed 
resistor is between the NE556 discharge lead and the capacitor; the variable 
resistor in the paddle is connected directly to the capacitor. On the 

Apple II Plus, the capacitor is connected directly to the discharge lead, and 
the fixed resistor is in series with the paddle resistor. 
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F.10 Cassette |/O 

a 8 ca me te a ee 
The Apple II, If Plus, and Ile all have cassette input and output jacks, 
memory locations, and Monitor support. The Apple IIc does not. 


UniDisk 3.5 If you plan to run a program on your IIc that handles cassette I/O, make 
sure that it does not access $C028. The Apple IIc with UniDisk 3.5 
support uses address $C028 to toggle between its two 16K banks of 
memory. 


F.11 Hardware 
a |e a ee oe ee ee] 


Besides the different microprocessors used in various models in the Apple II 
series (Section F.1.1), there are important differences in power 
specifications and custom chips. 
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F.11.1 Power 


aS) 

The power supplies for the Apple II, II Plus, and IIe are essentially the same. 
The floor transformer and voltage converter for the Apple IIc have smaller 
capacity for current and heat dissipation. Therefore, it is important to 
observe the load limits specified in each of the reference manuals - 


F.11.2 Custom Chips 
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The Apple Ile custom chips (memory management unit and input/output 
unit) replaced dozens of Apple II Plus chips, and added the functionality of 
dozens more. The Apple IIc has custom MMU and IOU chips, too, but they 
represent different bonding options, and so their pin assignments are not 
compatible. 


In addition, the Apple IIc has a custom general logic unit (GLU), taming 
generator (TMG), and disk controller unit (also known as an Integrated Woz 
Machine, or IWM). The Apple IIc has two hybrid units (AUD and VID) for 
audio and video amplification. 
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Appendix G USA and International Models 
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This appendix repeats some of the keyboard information given in Chapter 4 
for the two USA keyboard layouts, for easy comparison with the o ther 
layouts available. Following these is a composite table of the ASCII codes 
and the characters associated with them on all the models discussed. 


G.1 Keyboard Layouts and Codes 

a a a a eal 
Each of the following subsections has a keyboard illustration and a table of 
the codes that result from the possible keystrokes. Note, however, that 
Table G-1 is the basic table of keystrokes and their codes. For simplicity, 
subsequent tables (up to Table G-7) list only the keystrokes and codes that 
differ from those in Table G-1. 


For example, pressing the [a] key produces a (hexadecimal 61); pressing 
produces uppercase A (hexadecimal 41); pressing 

or produces SOH (the ASCI Start Of 
Header control character, hexadecimal 01). You can tell that this Key has 
the same effect on all keyboards, from the fact that nothing appears in 
Tables G-2 through G-7 for that key. 


A quick way to find out which characters in the ASCII set change on 
international keyboards is to check Table G-8. In fact, only a few of them 
change. The pairing of characters on keys varies more. 


Note: On all but the French and Italian keyboards, affects 
only keys that can produce both lowercase letters (with or without an 
accent) and their uppercase equivalents. With these keys, 
down is equivalent to holding down (SHIFT ], resulting in uppercase 
instead of lowercase. If a key produces only a lowercase version of an 
accented letter, then dees not affect it. 


On the French and Italian keyboards, shifts all the keys. 
Furthermore, on the French keyboard, when is down, the 
key undoes the shifting. 


The shapes and arrangement of keys in Figures G-1 and G-2 follow the 
ANSI (American National Standards Institute) standard, which is used 
mainly in North and South America. The shapes and arrangement of keys 
in Figure G-3 follow the ISO (International Standards Organization) 
standard used in Europe and elsewhere. 
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The only differences between the ANSI and ISO versions of the USA 


keyboard are 

o the shapes of three keys: the left key,(CAPS LOCK], and 

co the resulting repositioning of two keys ({7} and (~]) in Figures G-1 
and G-3 


O for some countries, the arrow symbols on {TAB],{CAPS LOCK], [RETURN ], 
and the two keys (as shown in Figure G-8). 


G.1.1 USA Standard (Sholes) Keyboard 


Figure G-] shows the standard (Sholes) keyboard as it is laid out for USA 
models of the Apple IIc with the keyboard switch up. Table G-1 lists the 
ASCII codes resulting from all simple and combination keystrokes on this 
keyboard. 


Figure G-1. USA Standard or Sholes Keyboard (Keyboard Switch Up) 


bane Basie [us use Pr 
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Table G-1. Keys and ASCII Codes 


Note: Codes are in hexadecimal here; refer to Table G-8 for decimal equdvalents. 


Key Key Alone 


Code 

TF 
[=] 08 
09 
(] OA 
[+] OB 
(RETURN) OD 
[=] 15 
[Esc ] 1B 
20 
_ 27 
,< 2C 
- 2D 
> 2E 

/? 2F 
0) 30 
1! 31 
2@ 32 
3# 33 
4 $ 34 
5% 30 
6 * 36 
7& 37 
8 * 38 
9 ( 39 
3B 

=+ 3D 
[{ 5B 
\ | oC 
1} BD 
: 60 


Char 


DEL 
BS 


Oo con on & wore © ™~™ 


+ CONTROL 
Code Char 
(F DEL 
08 BS 
09 HT 
OA LF 
OB VT 
OD CR 
15 NAK 
1B ESC 
20 SP 
rA| 

2C ; 

IF US 
2E 

2F / 
30 0 
3) l 
00 NUL 
33 3 
34 4 
35 D 
1E RS 
37 (/ 
38 8 
39 9 
3B 

3D = 
1B ESC 
1C FS 
1D GS 
60 


Appendix G: USA and International Models 


+ SHIFT 
Code Char 
TF DEL 
08 BS 
09 HT 
OA LF 
OB VT 
OD CR 
15 NAK 
1B ESC 
20 SP 
22 " 
3C < 
oF _ 
3k > 
oF : 

29 ) 
21 ! 
40 @ 
23 # 
24 $ 
25 % 
dE ‘ 
26 & 
2A * 
28 ( 
3A 

2B + 
7B { 
7C | 
7D \ 
7E : 


+ Both 
Code Char 
(F DEL 
08 BS 
09 HT 
OA LF 
OB VT 
OD CR 
15 NAK 
1B ESC 
20 SP 
22 a 
3C < 
IF US 
3k > 
oF ? 

29 ) 

21 

00 NUL 
23 # 
24 $ 

25 % 
lE RS 
26 & 
2A 

28 ( 

3A 

2B + 
IB ESC 
1C FS 
1D GS 
TE : 


Table G-1—continued. Keys and ASCII Codes 
Note: Codes are in hexadecimal here; refer to Table G-8 for decimal equivalents. 


Key Key Alone 


Code 


61 
62 
63 
64 
65 
66 
67 
68 
69 
6A 
6B 
6C 
6D 
6E 
OF 
70 
(al 
72 
73 
74 
15 
76 
(7 
78 
to 
7A 


N<xe sexs cy nae vEIOZABerArno" TA trwAoon +S 


Char 


— Fe — — = Oo = Oo oC Oo oS a 


N< * FS sc STM FB BD OD B 


+ CONTROL 
Code Char 
01 SOH 
02 STX 
03 ETX 
04 KOT 
05 ENQ 
06 ACK 
07 BEL 
08 BS 
09 HT 
OA LF 
OB VT 
OC FF 
OD CR 
OF SO 
OF SI 
10 DLE 
1] DC1 
12 DC2 
13 DC3 
14 DC4 
15 NAK 
16 SYN 
17 ETB 
18 CAN 
19 EM 
1A SUB 
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+ SHIFT 


Code 


4] 
42 
43 
ad 
45 
46 
47 
48 
49 
4A 
4B 
4C 
4D 
4h 
4k 
50 
ol 
52 
a 
o4 
DO 
56 
ol 
58 
59 
OA 


Char 


Nx<ewex sexs cy nwo vSe AZABrA CTT TOBA ITAwD Se 


+ Both 
Code Char 
0] SOH 
02 STX 
03 KTX 
04 KOT 
05 ENQ 
06 ACK 
07 BEL 
08 BS 
09 HT 
0A LF 
OB VT 
OC FF 
OD CR 
OK SO 
OF SI 
10 DLE 
ll DC1 
12 DC2 
13 DC3 
14 DC4 
15 NAK 
16 SYN 
17 ETB 
18 CAN 
19 EM 
1A SUB 


dol 


G.1.2 USA Simplified (Dvorak) Keyboard 
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Figure G-2 shows the Dvorak layout of the USA keyboard. Chara cters are 
paired up on keys in exactly the same way as on the USA standard 
keyboard; only individual key positions are changed. In fact, you. can 
change the keycap arrangement to match Figure G-2, lock the keyboard 
switch in its down position, and have a working Dvorak keyboard. All 
keystrokes produce the same ASCII codes as those shown in Table G-1. 


Figure G-2. USA Simplified or Dvorak Keyboard (Keyboard Switch Down) 


mi 0/40 ~ board [us use Jo 


7 { } 
[ ri delete 
? 
tab 7 


caps 
lock 
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G.1.3 ISO Layout of USA Keyboard 
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Figure G-3 shows the layout of all ISO European keyboards (except the 
Italian keyboard) when the keyboard switch is up. All keystrokes produce 
the same ASCII codes as those shown in Table G-1. 


Figure G-3. ISO Version of USA Standard Keyboard (Keyboard Switch Up) 


[nse] [av [om /a /o 


/ @ # § % . & * ( ) a3 
esc / 2 d 4 if 6 / 8 9 0 = delete 
—>/ 
| 
\ ra X 
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G.1.4 English Keyboard 
a ae ee ee ee) 


With the keyboard switch up, the English model of the Apple IIc keyboard 
layout is as shown in Figure G-3, and keystrokes produce the ASCII codes 
shown in Table G-1. 


With the keyboard switch down, the English model keyboard layout is as 
shown in Figure G-4. The change in ASCII code production (from that in 
Table G-1) is shown in Table G-2. 


The only changed character is the substitution of the British pound-sterling 
symbol (&) for the cross-hatch symbol (#) on the shifted 3-kKey. 


Figure G-4. English Keyboard (Keyboard Switch Down) 


a [oe a fa /c 


: 
delete 


Table G-2. English Keyboard Code Differences From Table G-1 
Note: Codes are in hexadecimal here; refer to Table G-8 for decimal equzvalents. 


Key Key Alone + CONTROL + SHIFT + Both 
Code Char Code Char Code Char Code Char 


38 33 5) 30 3 23 5 23 # 
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G.1.5 French Keyboard 


SSS 
With the keyboard switch up, the French model of the Apple IIc keyboard 


layout is as shown in Figure G-38, and keystrokes produce the ASCII codes 
shown in Table G-1. 


With the keyboard switch down, the French model keyboard layout is as 
shown in Figure G-5. The changes in ASCII code production (from that in 
Table G-1) are shown in Table G-3. 


Note that on the French keyboard,{(CaPs Lock |] shifts to the upper 
characters on all keys. With on, “unshifts” to the lower 
character on any key pressed with it. 


Figure G-5. French Keyboard (Keyboard Switch Down) 


= [fos a fa /c 


PA 
delete 
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Table G-3. French Keyboard Code Differences From Table G-1 
Note: Codes are in hexadecimal here; refer to Table G-8 for decimal equivalents. 


Key Key Alone + CONTROL + SHIFT + Both 
Code Char Code Char Code Char Code Char 


&1 % & % & 310] 31 I 
62 "BO "RO 92g 3928 
»8 90 °~«O 99 33.3 3 «C«‘S 
4 97 97 34. | 
(5 23 ( 98 ( 3 O# 35 
§ 6 eS ID GS % 6 ID GS 
a7 1 8 iD 8 97 37ST 
18 | 20! 38. 8 38.8 
69 Ce ic ~—s FS 39 «9 ic ~—s FS 
40 40 a 00 NUL 939 0 00 NUL 
va 99 (CY IB ESC 5B. ° 1B —C«ESG 
== bE IE ~—sRS TE IE ~—s- RS 
$* 4g 4 = i 7) 
1% 17 iW 7 QW %  % 2% % 
§ 60 60 3 =§ 93 § 
2 2C 2C SF? SF? 
3B SB OF oF 
F 3A 3A oF / oF O/ 


G.1.6 Canadian Keyboard 


With the keyboard switch up, the Canadian model of the Apple IIc keyboarc 
layout is as shown in Figure G-1, and keystrokes produce the ASCII codes 
shown in Table G-1. 


With the keyboard switch down, the Canadian model keyboard Layout 1s as 
shown in Figure G-6. The changes in ASCII code production (from that in 
Table G-1) are shown in Table G-4. 
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Figure G-6. Canadian Keyboard (Keyboard Switch Down) 


[fo (a /a 


edt fe [eye TE Tees Tae fo fb f= Te fae 
esc / Pd | 4 5 6 / 8 9 0 = delete 
| fej; i* |i? 
tab |W E R I 4 U / ? fa}|/u}\°% 
Lh 
control A S a G H i K l : return 
¢ 2 an 
= PEEP EEE PT 
Yofe pf 


caps 


lock . = <- > Vv 


Table G-4. Canadian Keyboard Code Differences From Table G-1 
Note: Codes are in hexadecimal here; refer to Table G-8 for decimal equivalents. 


Key Key Alone +CONTROL +SHIFT + Both 
Code Char Code Char Code Char Code Char 


a 32 2 00 NUL 5B 00 NUL 
38 33 3 38 3 23 s 23 5 
6§ 36 6 RS 1K oD R RS 1K 
ae 40) a TF DEL 7D é ay DEL 
u * 7G U 7C u ob ‘ 5) 0 ‘ 
~? 60 ESC 1B oF ? 1D GS 
é¢ 7B é 1G FS 5C C 1C FS 
"/ TE " TE ” ak / 2F / 
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G.1.7 German Keyboard 


With the keyboard switch up, the German model of the Apple IIc keyboard 
layout is as shown in Figure G-3, and keystrokes produce the ASCII codes 
shown in Table G-1. 


With the keyboard switch down, the German model keyboard layout is as 
shown in Figure G-7. The change in ASCII code production (from that in 
Table G-1) is shown in Table G-5. 


Figure G-7. German Keyboard (Keyboard Switch Down) 


(ner J [fo /a /o 


: delete 


on 
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Table G-5. German Keyboard Code Differences From Table G-1 


Note: Codes are in hexadecimal here, refer to Table G-8 for decimal equivalents. 


Key Key Alone + CONTROL + SHIFT + Both 
Code Char Code Char Code Char Code Char 


2” 32 2 32 2 29 29 
3§ 33 8 00 NUL 40 § 00 NUL 
6& 36 6 36 6 26 & 26 & 
ig 37 7 37 fl OF / OF / 
8 ( 38 8 38 8 28 ( 28 ( 
9) 39 g 39 g 29 ) 29 ) 
= 30 0 30 0 3D = 3D = 
R? TE =o 7E g SF 3F ? 
U ™m OU ID GS 5D OU 1D GS 
+* 2B “| 2B ++ 2A 2A * 
) i 0 1C FS BCC IC FS 
A 7B A 1B ESC 5B A 1B ESC 
#° 23 # 1E RS 5E : 1E RS 
<> 3C < 3C < B10) > BIO) > 
2C 2G 3B 3B 
OF OE 3A 3A 
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G.1.8 Italian Keyboard 
aaa eee ea) 


With the keyboard switch down, the Italian model keyboard layout is as 
shown in Figure G-8. The change in ASCII code production (from that in 
Table G-1) is shown in Table G-6. 


With the keyboard switch up, the Italian model keyboard produces exactly 
the same ASCII codes for each key, but what is displayed differs for the ten 
characters indicated with the circled numbers 0, 2-5, and 7-11 in Table G-8. 


Figure G-8. Italian Keyboard (Keyboard Switch Down 


(nee J [os [m /a /o 
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Table G-6. Italian Keyboard Code Differences From Table G-1 
Note: Codes are in hexadecimal here; refer to Table G-8 for decimal equivalents. 


Key Key Alone + CONTROL + SHIFT + Both 
Code Char Code Char Code Char Code Char 


& 1 26 & 26 & 3] l 31 l 
"2 22 . 22 : 32 7 32 2 
"3 27 at 33 3 33 3 
(4 28 ( 28 ( 34 4 34 4 
5 5C C 1C FS 35 5 1C FS 
e6 7D e 7D é 36 6 36 6 
\7 29 ) 29 ) a7 7 37 7 
$8 23 S 23 S 38 8 38 8 
a9 7B a 7B a 39 ) 39 9 
é0 5D é 1D GS 30 0 1D GS 
| TE i lE RS dE * 1E RS 
$* 24 $ 24 $ 2A * 2A 
u % 60 u 60 u 25 % 25 % 
§° 40 § 00 NUL 5B ‘ 1B ESC 
<> 3C < 3C < 3k > 3E > 
a 2C 2C oF ? oF i 
3B 3B 2E 2k 


~ 
>) 
co) 

~ 
> 
-) 

RO 
— 
{KS 
— 
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G.1.9 Western Spanish Keyboard 


With the keyboard switch up, the Western (that is, American) Spanish 
model of the IIc keyboard layout is as shown in Figure G-1, and keystrokes 
produce the ASCII codes shown in Table G-1. 


With the keyboard switch down, the Western Spanish model keyboard 
layout is as shown in Figure G-9. The change in ASCII code produ ction 
(from that in Table G-1) is shown in Table G-7. 


Figure G-9. Western Spanish Keyboard (Keyboard Switch Down) 


i d £ 5 ‘ / & * ( ) 1 
esc / 2 3 4 ii) 6 / 8 9 0 = O/elete 
0 “A § 
ow _fo fw fe fo dr fr fo Te fo fr Ti TE 
oo fats fo fe fo fe fy fe fe fw | fo 
2 / " 
Z X L / N M 
2 
ele} fo ete fe 
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Table G-7. Western Spanish Keyboard Code Differences From Table G-1 


Note: Codes are in hexadecimal here; refer to Table G-8 for decimal equivalents. 


Key Key Alone 


Code 
lj 31 
2 4 32 
3§ 33 
6 / 36 
— 7A | 

60 
~ § TE 
N 7C 
Me 2C 
a 2E 
¢” 7D 
<> 3C 


Char 
] 


2 
3 
6 


D> 


+ CONTROL 
Code Char 
31 l 

32 2 

33 3 

36 6 

PA | ‘ 

00 NUL 
TF DEL 
1C FS 
aC 

2E 

ID GS 
1E RS 
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+ SHIFT 
Code Char 
5B 
oD j 
23 § 
oF / 
1B ° 
oF 
40 § 
5COUC«‘N 
oF ? 
21 ! 

22 : 
3E > 


+ Both 
Code Char 
OB 
5D j 
23 
2F 7, 
7B ° 
00 NUL 
TF DEL 
1C FS 
oF ? 

21 ! 
1D GS 
1E RS 


369 


G.2 ASCII Character Sets 


ke 
Table G-8 lists the ASCII (American National Standard Code for Information 
Interchange) codes that the Apple IIc uses, as well as the decimal and 
hexadecimal equivalents. Where there are differences between character 
sets, an asterisked number in the main table refers to a column in. the 
following part of the table. 


Table G-8. ASCII Code Equivalents 


ASCII Dec Hex ASCII Dec Hex ASCII Dec Hex ASCII Dec Hex 


NUL 00 2* 7* 96 60 
SOH 01 A a 97 s«O6 
STX 02 B b 98 62 
ETX 083 C c 99 68 
KOT 04 D d 100 64 
ENQ 06 Ki e 101 65 
ACK 06 F f 102 66 
BEL 07 G g 103 67 
BS (08 H h 104 68 
HT 09 I i 105 69 
LF 10 J j 106 6A 
VE ou K k 107 «6B 
FF 12 L ] 108 6€ 
CR 8 M m 109 6D 
SO 14 N n 110 65 
S! 15 j 0 0 IIL ‘OF 
DLE 16 0 P p 112 70 
DC1 17 l Q q 113 71 
DC2 «18 2 R r 114 72 
DC3 19 3 S S 115 72 
DC4 20 4 T t 116 74 
NAK 21 5) U u 1 ie 
SYN 22 6 V V 118 76 
KTB 23 7 W W 119 77 
CAN 24 8 X x 120 78 
EM 25 9 Y y 121 79 
SUB 26 Z Z 122. 7A 
KSC 7 3° 8* 123 7B 
FS 28 < 4* 9* 124 TC 
GS =_4g = o* 10* 125 7D 
RS 30 > 6* 11* 126 TE 
US 3i ? = DEL 127 ‘FF 
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Table G-8—continued. ASCII Code Equivalents 
Note: These characters correspond to those followed by an asterisk in the preceding 
part of the table. 

0 1 2 383 4 5 6 F 8 9 10 11 


Hexadecimal 23 24 40 5B 5C 5D 5K 60 7B 7C 7D TE 


Engish(USA) # $ @[ \ ] a 
English(UK) § $ @[ \ ] f 1 
German # $ § A O JU i 6 t &B 
French § $ A c 6§ é a @ 
Italian § $ § Cn: ua 6 @ j 
Spanish § $ § ; N yj * . t= 


G.3 Certification 

rr eS 
In the countries where it is applicable, the following product safety 
certification supplements the USA FCC Class B notice printed on the inside 
front cover of this manual. The safety instructions apply to all countries. 


G.3.1 Product Safety 


ae ee ee en ee] 
This product is designed to meet the requirements of safety standard 
IEC 380, Safety of Electrically Energized Office Machines. 


G.3.2 Important Safety Instructions 
[SSS ee ee en 


This equipment is intended to be electrically grounded. This product is 
equipped with a plug having a third (grounding) pin. This plug will fit only 
into a grounding-type alternating current outlet. This is a safety feature. 


If you are unable to insert the plug into the outlet, contact a licensed 
electrician to replace the outlet and, if necessary, install a grounding 
conductor. 


Do not defeat the purpose of the grounding-type plug. 
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G.4 Power Supply Specifications 

a 20ST a ee | 
The basic specifications of the power supply furnished with the Apple IIc 
for use in Europe and other countries having 50-Hz alternating current are 
shown in Table G-8. 


Table G-8. 50-Hz Power Supply Specifications 


Line voltage: 199 to 255 VAC, 50 Hz 
Maximum input 

power consumption: 25 W 

Supply voltage: +15 VDC (nominal) 
Supply current: 1.2 A (nominal) 
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Appendix H Conversion Tables 


ere Et 


A 
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This appendix briefly discusses bits and bytes and what they can represent, 
and peripheral identification numbers. It also contains conversion tables for 
hexadecimal to decimal and negative decimal, and a number of 8-bit codes. 


These tables are intended for convenient reference. This appendix is not 
intended as a tutorial for the materials discussed. The brief section 
introductions are for orientation only. 


H.1 Bits and Bytes 


a a eS 


This section discusses the relationships between bit values and their 
position within a byte. Here are some rules of thumb regarding the 65C02: 


O 
C 


O 


A bit is a binary digit; it can be either a 0 or a 1. 

A bit can be used to represent any two-way choice. Some choices that a 
bit can represent in the Apple IIc are listed in Table H-1. 

Bits can also be combined in groups of any size to represent numbers. 
Most of the commonly used sizes are multiples of four bits. 

Four bits comprise a nibble (sometimes spelled nybble). 

One nibble can represent any of 16 values. Each of these values is 
assigned a number from 0 through 9 and (because our decimal system 
has only 10 of the 16 digits we need) A through F. 

Eight bits (two nibbles) make a byte (Figure H-1). 

One byte can represent any of 16 x 16 or 256 values. The value can be 
specified by exactly two hexadecimal digits. 

Bits within a byte are numbered from bit 0 on the right to bit 7 on the left. 
The bit number is the same as the power of 2 that it represents, in a 
manner completely analogous to the digits in a decimal number. 

One memory position in the Apple IIc contains one 8-bit byte of data. 
How byte values are interpreted depends on whether the byte is an 
instruction in a language, part or all of an address, an ASCII co de, or 
some other form of data. Tables H-5 through H-8 list some of the ways 
bytes are commonly interpreted. 

Two bytes make a word. The 16 bits of a word can represent amy one of 
256 x 256, or 65536, different values. 

The 65C02 uses a 16-bit word to represent memory locations. It can 
therefore distinguish among 65536 (64K) locations at any given time. 

A memory location is one byte of a 256-byte page. The low-order byte of 
an address specifies this byte. The high-order byte specifies the memory 
page the byte is on. 
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Table H-1. What a Bit Can Represent 


Context Representing 0= l= 
Binary number __‘ Place value 0 1 x that power of 2 
Logic Condition False True 
Any switch Position Off On 
Any switch Position Clear* Set 
Serial transfer Beginning Start Carrier (no information yet) 
Serial transfer Data 0 value 1 value 
Serial transfer Parity SPACE MARK 
Serial transfer End Stop bit(s) 
Serial transfer Communication BREAK Carrier 
state 
P reg. bit N Neg. result? No Yes 
P reg. bit V Overflow? No Yes 
P reg. bit B BRK command? No Yes 
P reg. bit D Decimal mode? No Yes 
P reg. bit I IRQ interrupts Enabled Disabled (masked out) 
P reg. bit Z Zero result? No Yes 
P reg. bit C Carry required? No Yes 
* Sometimes ambiguously termed reset. 
Figure H-1. Bits, Nibbles, and Bytes 
High Nibble Low Nibble 
MSB LSB 
7 6 5 4 3 2 1 0 


Hexadecimal $80 $40 $20 $10 $08 $04 $02 # $01 


Decimal 128 64 32 16 8 4, 2 1 
Binary Hex Dec Binary Hex Dec 
0000 $0 0 1000 $8 8 
0001 $1 ] 1001 $9 9 
0010 $2 2 1010 $A 10 
0011 $3 3 1011 $B 1] 
0100 $4 4 1100 $C 12 
0101 $5 5 1101 $D 13 
0110 $6 6 1110 $E 14 
0111 $7 ii 1111 $F 15 
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H.2 Hexadecimal and Decimal 
TT aa a ey 


Use Table H-2 for conversion of hexadecimal and decimal numbers. 


Table H-2. Hexadecimal/Decimal Conversion 


Digit $x000 $0x00 $00x0 $000x 
F 61440 3840 240) 15 
3 07344 3084 224 14 
D 03248 3328 208 13 
C 49152 3072 192 12 
B 45056 2816 176 9 
A 40960 2560 160 10 
9 36864 2304 144 9 
8 32768 2048 128 8 
‘i 28672 1792 112 (| 
6 24576 1536 96 6 
D 20480 1280 80 5) 
4 16384 1024 64 4 
3 12288 768 48 3 
2 8192 512 32 2 
4096 206 16 


To convert a hexadecimal number to a decimal number, find the decimal 
numbers corresponding to the positions of each hexadecimal digit. Write 


them down and add them up. 

Examples: 

$3C = ? $FD47 = ? 

$38 = 48 $FO08 = 61448 

$9C = 12 $¢ DOB = 3328 

eee $¢ 40 = 64 
$ 7s 7 

$3C = 68 — conneeeeueuee 


$FD47 = 64839 


To convert a decimal number to hexadecimal, subtract from the decimal 
number the largest decimal entry in the table that is less than it. Write 
down the hexadecimal digit (noting its place value) also. Now subtract the 
largest decimal number in the table that is less than the decimal remainder, 
and write down the next hexadecimal digit. Continue until you have 0 left. 
Add up the hexadecimal numbers. 
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Example: 


16215 = $ ? 
16215 - 12288 = 3927 12288 = $7608 
3927 - 3848 = 87 3848 = $ FOB 
87 - 86 = 7 88 = $ 586 
7 7 = $ 7 


H.3 Hexadecimal and Negative Decimal 

CEE Te eee 
If a number is larger than decimal 32767, Applesoft BASIC allows and 
Integer BASIC requires you to use the negative-decimal equivalent of the 
number. Table H-3 is set up to make it easy for you to convert a 
hexadecimal number directly to a negative-decimal number. 


Table H-3. Hexadecimal] to Negative Decimal Conversion 


Digit $x000 $$0x00 $$00x0 $$000x 
F 0 0) 0 a | 
BK — 4096 — 256 =16 —=—2Z 
D — 8192 —12 — 2 —3 
C — 12288 — 768 — 48 —4 
B — 16384 — 1024 — 64 —)d 
A — 20480 — 1280 = ou) 6 
9 — 24576 — 1596 00 =F 
8 — 28672 — 1792 = T1Z 0 
7 — 2048 == 126 =o 
6 — 2304 — 144 —10 
) — 2560 == 160 211 
A — 2816 ae =12 
3 — 3072 = 92 —13 
2 — 3328 — 208 —14 
] — 3584 — 224 —15 
0 — 3840 — 240 ==16 
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To perform this conversion, write down the four decimal numbers 
corresponding to the four hexadecimal digits (0s included). Them add their 
values (ignoring their signs for a moment). The resulting number, with a 
minus sign in front of it, is the desired negative-decimal number. 


Example: 

$CO18 = - ? 
$CO00: -12288 
$¢$ 000: - 3848 
$¢ 10: - 224 
$ 6: - 16 
$C818 -16368 


To convert a negative-decimal number directly to a positive-deci mal 
number, add it to 65536. (This addition ends up looking like subtraction. ) 


Example: 
-1Si = +? 
65536 + (€-151) = 65536 - 151 = 65385 


To convert a negative-decimal number to a hexadecimal number, first 
convert it to a positive-decimal number, then use Table H-2. 


H.4 Peripheral Identification Numbers 


Many Apple products now use peripheral identification numbers (called 
PIN numbers) as shorthand to designate serial device characteristics. The 
Apple II series Universal Utilities disk presents a menu from which to 
select the characteristics of, say, a printer or modem. From the selections 
made, it generates a PIN for the user. Other products have a ready-made 
PIN that the user can simply type in. 


Table H-4 is a definition of the PIN number digits. When communication 
mode is selected, the seventh digit is ignored. 


Example: 252/1111 means: 


Communication mode No parity 
8 data bits, 1 stop bit Do not echo output to display 
300 baud (bits per second) No line feed after carriage return 


Do not generate carriage returns 
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Table H-4. PIN Numbers 


1 = Printer mode 

2 = Communication mode* 
1 = 6 data bits, 1 stop bit 
2 = 6 data bits, 2 stop bits 
3 = 7 data bits, 1 stop bit 
4=7 data bits, 2 stop bits 
5 = 8 data bits, 1 stop bit 
6 = 8 data bits, 2 stop bits 
1 = 110 bits per second 

2 = 300 bits per second 

3 = 1200 bits per sec ond 
4 = 2400 bits per second 
5 = 4800 bits per sec ond 
6 = 9600 bits per second 
7 = 19200 bits per second 


1 = No parity 

2 = Even parity (total on = even) 
3 = Odd parity (total on = odd) 

4 = MARK parity (parity bit = 1) 
5 = SPACE parity (parity bit = 0) 


1 = Do not echo output on screen 
2, = Echo output on screen 


1 = Do not generate LF after CR 
2 = Generate LF after CR 


1 = Do not generate CR* 

2 = Generate CR after 40 characters 
3 = Generate CR after 72 characters 
4 = Generate CR after 80 characters 
5 = Generate CR after 132 characters 


* If you select communication mode, then seventh digit must equal 1. This value is supplied automatically when you use the UUD. 
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H.5 Eight-Bit Code Conversions 
aa a eg ee ee 
Tables H-5 through H-8 show the entire ASCII character set. Note that 
character values are shown with the high bit off. Unless otherwise noted, all 
ASCII character values above $7F (127 decimal) generate the sarme 
character as that value with the high bit off. Here is how to interpret these 
tables: 


O 
O 


G 


O 


a 


O 


O 


The Binary column has the 8-bit code for each ASCII character. 

The first 128 ASCII entries represent 7-bit ASCII codes plus a high-order 
bit of 0 (SPACE parity or Pascal)—for example, 01001000 for the 

letter 7. 

The last 128 ASCII entries (from 128 through 255) represent 7-bit ASCII 
codes plus a high-order bit of 1 (MARK parity or BASIC)—for example, 
11001000 for the letter H. 

A transmitted or received ASCII character will take whichever form (in 
the communication register) is appropriate if odd or even parity is 
selected—for example, 11001000 for an odd-parity 1, 01001000 for an 
even-parity 7. 

The ASC// Char column gives the ASCII character name. 


The Interpretation column spells out the meaning of special symbols 
and abbreviations, where necessary. 


The What to Type column indicates what keystrokes generate the ASCII 
character (where it is not obvious). 

The columns marked P77 and Alt indicate what displayed character 
results from each code when using the primary or alternate display 
character set, respectively. Boldface is used for inverse characters; italic 
is used for flashing characters. 


Note that the values $40 through $5F (and $CO0 through $DF) in the 
alternate character set are displayed as MouseText characters 
(Figure 5-1) if the firmware is set to do so (Section 5.2.2), or if the 
firmware is bypassed. 


Note: The primary and alternate displayed character sets in T ables H-5 
through H-8 are the result of firmware mapping. The character generator 
ROM actually contains only one character set. The firmware mapping 
procedure is described in Section 3.3.6. 
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Table H-5. Control Characters, High Bit Off 


ASCII 
Binary Dec Hex Char Interpretation What to Type 
0000000 0 $00 NUL Blank (null) (CONTROL }{@] 
0000001 1 $01 SOH Start of Header (CONTROL }-[{A] 
0000010 2 $02 STX Start of Text [CONTROL }{B] 
0000011 3 $03 ETX End of Text (CONTROL }{C] 
0000100 4 $04 EOT End of Transm. (CONTROL }-[D] 
0000101 5 $05 ENQ Enquiry (CONTROL }-{E] 
0000110 6 $06 ACK Acknowledge (CONTROL }[F] 
0000111 7 $07 BEL Bell (CONTROL }-(G] 
0001000 8 $08 BS Backspace (CONTROL }-(H] or [=] 
0001001 9 $09 HT Horizontal Tab [CONTROL }{1] or 
0001010 10 $0A LF Line Feed (CONTROL }-(J] or [4] 
0001011 11 $0B VT Vertical Tab [CONTROL }{K] or [+] 
0001100 12 $0C FF Form Feed [CONTROL }{L] 
0001101 13 $0D CR Carriage Return (CONTROL }{m] or 
0001110 14 $0E SO Shift Out [CONTROL }{N] 
0001111 15 $OF SI Shift In (CONTROL }{0] 
0010000 16 $10 DLE Data Link Escape = (CONTROL}{P] 
0010001 17 $11 DCl Device Control 1 (CONTROL }[Q] 
0010010 18 $12 DC2 Device Control 2 (CONTROL }-[R] 
0010011 19 $13 DC3 Device Control 3 (CONTROL }[S] 
0010100 20 $14 DC4 Device Control 4 (CONTROL }{T] 


0010101 21 $15 NAK Neg. Acknowledge (ConTROL}{UJor [=] 
0010110 22 $16 SYN Synchronization (CONTROL }-[V] 
0010111 23 $17 ETB End of Text Blk. (CONTROL }{W] 


an) 
a. 
= 
= 


0011000 24 $18 CAN Cancel (CONTROL }{X] 
0011001 25 $19 EM End of Medium 
0011010 26 $1A SUB Substitute (CONTROL }{Z] 
0011011 27 $1B ESC Escape (CONTROL }{T] or 
0011100 28 $1C FS File Separator (CONTROL }-(\] 
0011101 29 $1D GS Group Separator (CONTROL }{7] 
0011110 30 $1E RS Record Separator [CONTROL }{*] 


0011111 a SIF US Unit Separator 


[ConTROL }{_} 
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Table H-6. Special Characters, High Bit Off 


Binary 


0100000 
0100001 
0100010 
0100011 
0100100 
0100101 
0100110 
0100111 
0101000 
0101001 
0101010 
0101011 
0101100 
0101101 
0101110 
0101111 
0110000 
0110001 
0110010 
0110011 
0110100 
0110101 
0110110 
0110111 
0111000 
0111001 
0111010 
0111011 
0111100 
0111101 
0111110 
Q111111 
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Hex 


$20 
$21 
$22 
$23 
$24 
$25 
$26 
$27 
$28 
$29 
SOA 
$2B 
$2C 
$2D 
$2E 
$2F 
$30 
$31 
$32 
$33 
$04 
$35 
$36 
$37 
$38 
$39 
$3A 
$3B 
$3C 
$3D 
$38 
$3F 


ASCII 
Char 


SP 


oOoonnonfr WHF Oo”. 


VAT 


Interpretation 


Space 


Closing quote 


Comma 
Hyphen 
Period 
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i ia eos 


econo rh WD = OS™ ° 


we ee 


yA 


Alt 


> On 
~~ 


a 2 7 —N * GSH H 


oon qwrt WN S™ ° 


we ee 


yl A 


Table H-7. Uppercase Characters, High Bit Off 


ASCII 
Binary Dec Hex Char Interpretation What to Type 


1000000 64 $40 
1000001 65 $41 
1000010 66 $42 
1000011 67 $43 
1000100 68 $44 
1000101 69 $45 
1000110 70 $46 
1000111 71 $47 
1001000 72 $48 
1001001 73 $49 
1001010 74 $4A 
1001011 15 $4B 
1001100 76 $4C 
1001101 U7 $4D 
1001110 78 34K 
1001111 79 34F 
1010000 80 $50 
1010001 81 $51 
1010010 82 $52 
1010011 83 $53 
1010100 84 $54 
1010101 85 $55 
1010110 86 $56 
1010111 87 $57 
1011000 88 $58 
1011001 89 $59 
1011010 90 SOA 


a 
=F 


-TN< XM ES CHNDOVOZZOASCT*ITOIMSAOWFSES 
o = — NSH ETGHAVOVSOSARSOARS SQ SBOoasr@® 
Ll OU NRT AEE LC: TREK OR EF 


1011011 9] $5B Opening bracket 

1011100 92 $5C Reverse slant 

1011101 93 $5D Closing bracket 

1011110 94 $5E a Caret 

1011111 95 $5F = Underline _ 


* If the high bit is set, the MouseText characters are replaced with their equivalent in the primary character set with that value. 


H.5 Eight-Bit Code Conversions 


Table H-8. Lowercase Characters, High Bit Off 


Binary 


1100000 
1100001 
1100010 
1100011 
1100100 
1100101 
1100110 
1100111 
1101000 
1101001 
1101010 
1101011 
1101100 
1101101 
1101110 
1101111 
1110000 
1110001 
1110010 
1110011 
1110100 
1110101 
1110110 
1110111 
1111000 
1111001 
1111010 
1111011 
1111100 
1111101 
1111110 
1111111 
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Hex 


$60 
$61 
$62 
$63 
$64 
$65 
366 
$67 
$68 
$69 
$6A 
$6B 
$6C 
$6D 
$6E 
SOF 
$70 
$71 
$72 
$73 
$74 
375 
$76 
377 
$78 
$79 
STA 
$7B 
$7C 
$7D 
$7E 
$7F 


ASCII 
Char 


iow TON KE TT ee 


DEL 


Interpretation What to Type 


Opening quote 


Opening brace 
Vertical line 
Closing brace 
Overline (tilde) 
Delete/rubout 


Appendix H: Conversion Tables 


© Co ~ SMD GT & GO A DS" 


SV AT 


Alt 


ro“ TN MH ES SEtTHOBAeVos Fre em meeac ee 


DEL 


Appendix | Firmware Listings 


380 


386 


Appendix | is a listing of the source code for the Monitor, enhanced video 
firmware, and input/output firmware contained in the version of the 
Apple IIc that supports UniDisk 8.5. 


If you find that you absolutely must develop software or hardware for an 
original Apple IIc that will not be upgraded in the future, you can get a 
listing of the old source code by filling out and mailing the order form in the 
back of this manual. 


Appendix I: Firmware Listings 
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*@8L9 
*8819 
2Be 31143 3QNIONI 


8084 *0808 
*8860 
79808 
*8006 
6006 
80686 


08086 6086 
WYI4d 18 


2SaOLI3A< = 
YIONVE<= 
JISVEW<e> 
CNVWWOD< = 
cU3ZHILIMS<= 
cUIONVE< = 
JINLISXNY<= 
LNIW<= 
cANVE<= 
2LSOLNY<= 
bisOlny<= 
IS IW3I90W< = 
WISd<s 
3dVIS3<= 
ONI11049S<= 


INI We= 
JNGDYI <= 
SAHOLIMS<= 
100a<= 
ISIWS= 
3d0IW<= 
3SNOW< = 
JIvdSEI<= 
WWO9<= 
y3S<= 
WIyas<= 
S3LUNDI<= 
S3WUN<= 
Wal4¢= 


6ee 
82a 
Lee 
928 
See 
bee 
Eve 
coce 
Lee 
ce 
6le 
Ble 
Lhe 
Sle 
Sle 


ble 
Ele 
cle 
Lle 
Ole 
6be 
8be 
Léa 
900 
S6e 
bbe 
e6e 
28e 
LOe 


3114 
3114 
3114 
3114 
3114 
3114 
3114 
3114 
3114 
3114 
3114 
3114 
3114 
3114 
3114 


34 
a4 
3114 
3114 
a4 
a4 
314 
3114 
a4 
a4 
3114 
3114 
a4 
3114 
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3qN NI 
JqN ISN I 
Jan ION I 
3qN1SNI 
JqaN1ONI 
JaN ION I 
JGNIINI 
JaNIONI 
JaN INI 
3qN SONI 
JqN NI 
JqN NI 
JaN INI 
JaNISNI 
3qaN INI 


JGA7SNI 
3QNI0NI 
3aN9NI 
30NI9NI 
3aNONI 
30N19NI 
30NT0NI 
30NT0NI 
3QN0NI 
3QN9NI 
30NT9NI 
30N10NI 
3aN19NI 
30gNOS 
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Glossary 


65C02: The microprocessor used in 
the Apple IIc computer. 


ACIA: Asynchronous 
communications interface adapter. 
A single chip that converts data 
from parallel to serial form, and vice 
versa, and handles serial 
transmission and reception and 
RS-232-C signals, under the control 
of its internal registers set and 
changed by firmware or software. 


accumulator: The register in the 
6502 and 65C02 microprocessors 
where most computations are 
performed. 


acronym: A word formed from the 
initial letters of a name or phrase, 
such as ROM, frorn read-only 
memory. 


ADC: See analog-to-digital 
converter. 


address: A number used to identify 
something, such as a location in the 
computer's memory. 


analog: Represented in terms of a 
physical quantity that can vary 
smoothly and continuously over a 
range of values. F’or example, a 
conventional 12-hour clock face is 
an analog device that represents the 
time of day in terms of the angles of 
the clock’s hands. Compare digital. 


analog-to-digital converter: A 
device that converts quantities from 
analog to digital form. For example, 
the Apple IIc’s hand controller 
converts the position of the 
controller dial (an analog quantity) 
into a discrete number (a digital 
quantity ) that changes in steps even 
when the dial is turned smoothly. 


AND: A logical operator that 
produces a true result if both of its 
operands are true, a false result if 
either or both of its operands are 
false; compare OR, exclusive OR, 
NOT. 


Applesoft: An extended version of 
the BASIC programming language 
used with the Apple IIc computer. 
The firmware for interpreting and 
executing programs in Applesoft is 
included in the Apple IIc ROM. 


ASCII: American Standard Code 
for Information Interchange; a code 
in which the numbers from 0 to 127 
stand for text characters, used for 
representing text inside a computer 
and for transmitting text between 
computers or between a computer 
and a peripheral device. 


Glossary 


assembler: A language translator 
that converts a program written in 
assembly language into an 
equivalent program in machine 
language. 


assembly language: A low-level 
programming language in which 
individual machine-language 
instructions are written in a 
symbolic form more easily 
understood by a human programmer 
than machine language itself. 


asserted: Made true (positive in 
positive-true logic; negative in 
negative-true logic). 


asynchronous: Having a variable 
time interval between characters. 


back panel: The rear face of the 
Apple IIc computer, which includes 
the power switch, the power 
connector, and connectors for two 
serial devices, a video display 
device, an external disk drive, and a 
mouse or hand control. 


bandwidth: A measure of the 
range of frequencies a device can 
handle. In the case of a video 
monitor, greater bandwidth enables 
it to display more information; to 
display 80 columns of text, a 
monitor should have a bandwidth of 
at least 12 MHz. 
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base address: In indexed 
addressing, the fixed component of 
an address. 


baud: A unit of signaling speed 
equal to the number of discrete 
conditions or signal events per 
second. Often equated (though not 
precisely) with bits per second. 


binary: The representation of 
numbers in terms of powers of 2, 
using the two digits 0 and 1. 
Commonly used in computers, since 
the values 0 and 1 can easily be 
represented in physical form in a 
variety of ways, such as the 
presence or absence of current, 
positive or negative voltage, or a 
white or black dot on the display 
screen. 


bit: A binary digit (0 or 1); the 
smallest possible unit of 
information, consisting of a simple 
two-way choice, such as yes or no, 
on or off, positive or negative, 
something or nothing. 


board: See printed-circuit board. 


boot: To start up a computer by 
loading a program into memory 
from an external storage medium 
such as a disk. Often accomplished 
by first loading a small program 
whose purpose is to read the larger 
program into memory. The program 
is said to pull ctselfin by its own 
bootstraps. 
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bootstrap: See boot. 


BREAK: A SPACE (0) signal sent 
over a communication line, of long 
enough duration to interrupt the 
sender. This signal is often used to 
end a session with a timesharing 
service. 


BRK: A 65C02 instruction that 
causes the microprocessor to halt. 


buffer: An area of the computer’s 
memory used as a holding area 
where information can be stored by 
one program or device and then 
read out by another at a different 
speed. 


bus: A group of wires that transmit 
related information from one part of 
a, computer system to another. In 
the Apple IIc, the address bus has 
16 wires, and the data bus has 8. 


byte: A unit of information 
consisting of a fixed number of bits; 
on the Apple IIc, one byte consists 
of eight bits and can represent any 
value between 0 and 255. 
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carriage return: An AS Cll 
character (decimal 13; Appendix H) 
that ordinarily causes a printer or 
display device to place the 
subsequent character on the left 
margin. On a manual typewriter, 
this movement is combined with 
line feed (the advancement of the 
paper to the next line). With 
computers, carriage return and line 
feed are separate, causing 
hair-raising problems for the user. 


carrier: The background signal on 
a communication channel that is 
modified to carry the information. 
Under RS-232-C rules, the carrier 
signal is equivalent to a continuous 
MARK (1) signal; a transition to 0 
then represents a start bit. 


carry flag: The C bit in the 65002 
processor status register, used to 
hold the carry bit in addition and 
subtraction. 


cathode-ray tube: An electronic 
device, such as a television picture 
tube, that produces images on a 
screen coated with phosphors that 
emit light when struck by a focused 
beam of electrons. 


central processing unit: See 
processor. 


character: A letter, digit, 
punctuation mark, or other symbol 
used in printing, displayin g or 
transferring information. 


character codes A number used to 
represent a text character for 
processing by a computer system. 


chip: The small piece of 
semiconducting material (usually 
silicon) on which an integrated 
circuit is fabricated. 


Clear To Send: An RS-232-C signal 
from a DCE to a DTE that is 
normally kept fal se until the DCE 
makes it true, indicating that all 
circuits are ready to transfer data 
out. 


code: (1) A number or symbol used 
to represent some piece of 
information in a Compact or easily 
processed form. (2) The statements 
or instructions making up a 
program. 


cold start: The process of starting 
up the Apple IIc when the power is 
first turned on (or as if the power 
had just been turned on) by loading 
the operating system into main 
memory, then loading and running a 
program. Compare warm start. 


command: A communication from 
the user to a com puter system 
(usually typed from the keyboard) 
directing it to perform some action. 


command character: An ASCII 
character, usually CONTROL-A or 
CONTROL-I, that causes the serial 
port firmware to interpret 
subsequent characters as a 
command. 


command register: An ACIA 
location (at address $CO9A for port 1 
and $COAA for port 2) that stores 
parity type and RS-2382-C signal 
characteristics. 


communication mode: An 
operating state in which serial 
port 2 (or 1, if so set) is prepared to 
exchange data and signals with a 
DCE (such as a modem). 


compiler: A language translator 
that converts a program written in a 
high-level programming language 
into an equivalent program in some 
lower-level language (such as 
machine language) for later 
execution. Compare interpreter. 


composite video: A video signal 
that includes both display 
information and the synchronization 
(and other) signals needed to 
display it. 


computer: An electronic device for 
performing predefined 
(programmed) computations at high 
speed and with great accuracy. 
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computer system: A computer 
and its associated hardware, 
firmware, and software. 


connector: A physical device such 
as a plug, socket, or jack, used to 
connect two devices to one another. 


control character: A character 
that controls or modifies the way 
information is printed or displayed. 
Control characters have ASCII 
codes between $00 and $1F (or 
between $80 and $9F if the 
high-order bit is set)). You can 
generate them at the Apple IIc 
keyboard by holding down the 


key while typing one of 
the letter keys or[{ \ ] or —. 


control register: An ACIA 
location (at address $CO9B for 
port 1, or $COAB for port 2) that 
stores data format and baud rate 
selections. 


CPU: Central processing unit; see 
processor. 


CRT: See cathode-ray tube. 
CTS: See Clear To Send. 


cursor: A symbol displayed on the 
screen that marks where the user’s 
next action will take effect or where 
the next character typed from the 
keyboard will appear. 


DAC: See digital-to-analog 
converter. 


data: Information; especially 
information used or operated on by 
a program. 


data bit: One of five to eight bits 
representing a character. 


Data Carrier Detect: An 
RS-232-C signal from a DCE (such 
as a modem) to a DTE (such as an 
Apple IIc) indicating that a 
communication connection has 
been established. 


Data Communication 
Equipment: As defined by the 
RS-232-C standard, any device that 
transmits or receives information. 
Usually this is a modem. However, 
when a Modem Eliminator is used, 
the Apple IIc itself looks like a DCE 
to the other device, and the other 
device looks like a DCE to the 
Apple Ile. 


data format: The form in which 
data are stored, manipulated, or 
transferred. Serial data transmitted 
and received by port 1 or 2 have a 
data format of: one start bit, five to 
eight data bits, an optional parity 
bit, and one, one and a half, or two 
stop bits. 
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Data Set Ready: An RS-232-C 
signal from a DCE toa DTE 
indicating that the DCE has 
established a connection. 


Data Terminal Equipment: As 
defined by the RS-232-C standard, 
any device that generates or absorbs 
information, thus acting as a 
terminus of a communication 
connection. 


Data Terminal Ready: An 
RS-232-C signal from a DTE to a 
DCE indicating a readiness to 
transmit or receive data. 


DCD: See Data Carrier Detect. 


DCE: See Data Communication 
Equipment. 


debug: To locate and correct an 
error or the cause of a problem or 
malfunction in a computer system. 
Typically used to refer to 
software-related problems. 


decimal: The common form of 
number representation in everyday 
usage, in which numbers are 
expressed in terms of powers of 10, 
using the ten digits 0 to 9. 


default: A value, action, or setting 
that is assumed or set in the 
absence of explicit instructions 
otherwise. 
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demodulate: To recover the 
information being transmitted by a 
modulated signal; for example, a 
conventional radio receiver 
demodulates an incoming. broadcast 
signal to convert it into sound 
emitted by a speaker. 


device: (1) A physical ap paratus for 
performing a particular task or 
achieving a particular purpose. 

(2) In particular, a hardware 
component of a computer system. 


digit: (1) One of the characters 0 

to 9, used to express numbers in 
decimal form. (2) One of the 
characters used to express numbers 
in some other form, such as 0 and 1 
in binary or 0 to9 and AtoF in 
hexadecimal. 


digital: Represented in a discrete 
(noncontinuous ) form, such as 
numerical digits. For example, 
contemporary digital clocks display 
the time in numerical form (such 
as 2:57) instead of using the 
positions of a pair of hands ona 
clock face. Compare analog. 


digital-to-analog converter: A 
device that converts quantities from 
digital to analog form. 


DIP: See dual in-line package. 


disassembler: A language 
translator that converts a 
machine-language program into an 
equivalent program in assembly 
language, more easily understood by 
a human programmer. The opposite 
of an assembler. 


disk: An information storage 
medium consisting of a flat, circular 
magnetic surface on which 
information can be recorded in the 
form of small magnetized spots, 
similarly to the way sounds are 
recorded on tape. 


disk drive: A device that writes 
and reads information on the 
surface of a magnetic disk. 


diskette: A term sometimes used 
for the small (54-inch) flexible 
disks used with the Apple Disk II 
drive. 


Disk IIc drive: A model of disk 
drive made and sold by Apple 
Computer for use with the Apple IIc 
computer; uses 54-inch flexible 
(floppy) disks. 


Disk Operating System: An 
optional software system for the 
Apple Ile that enables the computer 
to control and communicate with 
one or more Disk II drives. 


display: (1) Information exhibited 
visually, especially on the screen of 
a display device. (2) To exhibit 
information visually. (3) A display 
device. 


display device: A device that 
exhibits information visually, such 
as a television receiver or video 
monitor. 


display screen: The glass or 
plastic panel on the front of a 
display device, on which images are 
displayed. 


DOS: See Disk Operating 
System. 


DSR: See Data Set Ready. 


DTE: See Data Terminal 
Equipment. 


DTR: See Data Terminal Ready. 


dual in-line package: An 
integrated circuit packaged in a 
narrow rectangular box with a row 
of metal pins along each side; 
Similar in appearance to an armored 
centipede. 


echo: To send an input character to 
a video display, printer, or other 
output device. 


edit: To change or modify; for 
example, to insert, remove, replace, 
or move text in a document. 
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editor: A program that enables the 
user to create and edit information 

of a particular form; for example, a 

text editor or a graphics editor. 


effective address: In 
machine-language programming, 
the address of the memory location 
on which a particular instruction 
actually operates, which may be 
arrived at by indexed addressing or 
some other addressing method. 


emulation mode: A manner of 
operating in which one computer or 
interface imitates another. 


even parity: Use of an extra bit set 
to 0 or 1 as necessary to make the 
total number of 1 bits (among the 
data bits plus the parity bit) an even 
number. 


error message: A message 
displayed or printed to notify the 
user of an error or problem in the 
execution of a program. 


escape mode: A state of the 
Apple IIc computer, entered by 
pressing the key, in which 
certain keys on the keyboard take 
on special meanings for positioning 
the cursor and controlling the 
display of text on the screen. 
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escape sequence: A sequence of 
keystrokes, beginning with [Esc], 
used for positioning the cursor and 
controlling the display of text on the 
screen. 


exclusive OR: A logical operator 
that produces a true result if one of 
its operands is true and the other 
false, a false result if its operands 
are both true or both false; compare 
OR, AND, NOT. 


execute: To perform or carry out a 
specified action or sequence of 
actions, such as those described by 
a program. 


firmware: Software stored 
permanently in hardware: programs 
in read-only memory (ROM). Such 
programs (for example, the 
Applesoft interpreter and the 

Apple IIc Monitor program) are built 
into the computer at the factory; 
they can be executed at any time 
but cannot be modified or erased 
from main memory. Compare 
hardware, software. 


fixed-point: A method of 
representing numbers inside the 
computer in which the decimal 
point (more correctly, the binary 
point) is considered to occur at a 
fixed position within the number. 
Typically, the point is considered to 
lie at the right end of the number, so 
that the number is interpreted as an 
integer. Compare floating-point. 
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flexible disk: A disk made of 
flexible plastic; often called a 
floppy disk. Compare rigid disk. 


floating-point: A method of 
representing numbers inside the 
computer in which the decimal 
point (more correctly, the binary 
point) is permitted to float to 
different positions within the 
number. Some of the bits within the 
number itself are used to keep track 
of the point’s position. Compare 
fixed-point. 


form feed: An ASCII character 
(decimal 12; Appendix H) that 
causes a printer or other 
paper-handling device to advance to 
the top of the next page. 


framing error: In serial data 
transfer, absence of the expected 
stop bit(s) at the end of a received 
character. The serial port 1 and 2 
ACIAs record this error by setting 


bit 1 (FRM) of its status register to 1. 


The ACIA checks and records each 
framing error separately: if the next 
character is OK, the FRM bit is 
cleared. 


full duplex: Capable of 
simultaneous two-way 
communication. 
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graphics: (1) Information 
presented in the form of pictures or 
images. (2) The display of pictures 
or images on a computer’s display 
screen. Compare text. 


half duplex: Capable of 
communication in one direction at a 
time. 


hand controller: An optional 
peripheral device that can be 
connected to the Apple IIc’s hand 
controller connector and has a 
rotating dial and a pushbutton; 
typically used to control 
game-playing programs, but can be 
used in more serious applications as 
well. 


hand controller connector: A 
9-pin connector on the Apple IIc’s 
back panel, used for connecting 
hand controllers to the computer. 


hardware: Those components of a 
computer system consisting of 
physical (electronic or mechanical) 
devices. Compare software, 
firmware. 


hertz: The unit of frequency of 
vibration or oscillation, also called 
cycles per second; named for the 
physicist Heinrich Hertz and 
abbreviated Hz. The Apple IIc’s 
65C02 microprocessor operates at a 
clock frequency of 1 million hertz, 
or 1 megahertz (MHz). 


hexadecimal: The representation 
of numbers in terms of powers of 
sixteen, using the sixteen digits 0 
to 9 and A to F. Hexadecimal 
numbers are easier for humans to 
read and understand than binary 
numbers, but can be converted 
easily and directly to binary form: 
each hexadecimal digit corresponds 
to a sequence of four binary digits, 
or bits. 


high-level language: A 
programming language that is 
relatively easy for humans to 
understand. A single statement in a 
high-level language typically 
corresponds to several instructions 
of machine language. 


high-order byte: The more 
significant half of a memory address 
or other two-byte q uantity. In the 
Apple IIc’s 65C02 microprocessor, 
the low-order byte of an address is 
usually stored first and the 
high-order byte second. 


high-resolution graphics: The 
display of graphics on the 

Apple IIc’s display screen as a 
six-color array of points, 

280 columns wide and 192 rows 
high. 


hold time: In computer circuits, 
the amount of time a signal must 
remain valid after some related 
signal has been turned off; compare 
setup time. 


Hz: See hertz. 
IC: See integrated circuit. 


index: (1) A number used to 
identify a member of a list or table 
by its sequential position. (2) A list 
or table whose entries are identified 
by sequential position. (3) In 
machine-language programming, 
the variable component of an 
indexed address, contained in an 
index register and added to the base 
address to form the effective 
address. 


indexed addressing: A method of 
specifying memory addresses used 
in machine-language programming. 


index register: A register in a 
computer processor that holds an 
index for use in indexed addressing. 
The Apple IIc’s 65C02 
microprocessor has two index 
registers, called the X register and 
the Y register. 
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input: (1) Information transferred 
into a computer from some external 
source, such as the keyboard, a disk 
drive, or a modem. (2) The act or 
process of transferring such 
information. 


instruction: A unit of a 
machine-language or 
assembly-language program 
corresponding to a single action for 
the computer’s processor to 
perform. 


integer: A whole number, with no 
fractional part; represented inside 
the computer in fixed-point form. 
Compare real number. 


integrated circuit: An electronic 
component consisting of many 
circuit elements fabricated on a 
single piece of semiconducting 
material, such as silicon; see chip. 


interface: The devices, rules, or 
conventions by which one 
component of a system 
communicates with another. 


interpreter: A language translator 
that reads a program written in a 
particular programming language 
and immediately carries out the 
actions that the program describes. 
Compare compiler. 


477 


interrupt: A temporary suspension 
in the execution of a program by a 
computer in order to perform some 
other task, typically in response to a 
signal from a peripheral device or 
other source external to the 
computer. 


inverse video: The display of text 
on the computer's display screen in 
the form of black dots on a white (or 
other single phosphor color) 
background, instead of the usual 
white dots on a black background. 


1/0: Input/output; the transfer of 
information into and out of a 
computer. See input, output. 


1/0 device: Input /output device; a 
device that transfers information 
into or out of a computer. See 
input, output, peripheral 
device. 


I/O link: A fixed location that 
contains the address of an 
input /output subroutine in the 
Apple IIc Monitor program. 


K: Two to the tenth power, or 1024 
(from the Greek root k2/o, meaning 
one thousand); for example, 64K 
equals 64 times 1024, or 65,536. 


keyboard: The set of keys built 
into the Apple Ic computer, similar 
to a typewriter keyboard, for typing 
information to the computer. 
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keystroke: The act of pressing a 
single key or a combination of keys 


(such as [CONTROL }{ C ]) on the 
Apple IIc keyboard. 


kilobyte: A unit of information 
consisting of 1K (1024) bytes, or 
8K (8192) bits; see K. 


KSW: The symbolic name of the 
location in the Apple IIc’s memory 
where the standard input link is 


stored; stands for keyboard switch. 


See I/O link. 


language: See programming 
language. 


language translator: A system 
program that reads a program 
written in a particular programming 
language and either executes it 
directly or converts it into some 
other language (such as machine 
language) for later execution. See 
interpreter, compiler, 
assembler. 


least significant bit: The 
right-hand bit of a binary number as 
written down; its positional value 

is Qor 1. 


line feed: An ASCII character 
(decimal 10; Appendix H) that 
ordinarily causes a printer or video 
display to advance to the next line. 
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load: To transfer information from 
a peripheral storage medium (such 
as a disk) into main memory for use; 
for example, to transfer a program 
into memory for execution. 


local: Nearby; capable of direct 
connection using wires only. 


location: See memory location. 


logical operator: An operator, 
such as AND, that combines logical 
values to produce a logical result. 


low-level language: A 
programming language that is 
relatively close to the forrm that the 
computer’s processor can execute 
directly. Low-level languages 
available for the Apple IIc include 
65C02 machine language and 65C02 
assembly language. 


low-order byte: The less 
significant half of a memory address 
or other two-byte quantity. In the 
Apple IIc’s 65C02 microprocessor, 
the low-order byte of an address is 
usually stored first and the 
high-order byte second. 


low-power Schottky: A type of 
TTL integrated circuit having lower 
power and higher speed than a 
conventional TTL integrated circuit. 


low-resolution graphics: The 
display of graphics on the 

Apple IIc’s display screen as a 
16-color array of blocks, 40 columns 
wide and 48 rows high. 


machine language: The form in 
which instructions. to a computer 
are stored in memory for direct 
execution by the computer's 
processor. Each model of computer 
processor (such as the 65C02 
microprocessor used in the 

Apple IIc) has its own form of 
machine language. 


main memory: T he memory 
component of a cormputer system 
that is built into the computer itself 
and whose contents are directly 
accessible to the processor. 


MARK parity: A bit of value 1 
appended to a binary number for 
transmission. The receiving device 
can then check for errors by looking 
for this value on each character. 


memory: A hardware component 
of a computer system that can store 
information for later retrieval; see 
main memory, random-access 
memory, read-only memory, 
read-write memory. 


memory location: A unit of main 
memory that is identified by an 
address and can hold a single item 
of information of a fixed size; in the 
Apple IIc, a memory location holds 
one byte, or eight bits, of 
information. 


MHz: Megahertz; one million hertz. 
See hertz. 


microcomputer: A computer, such 
as the Apple IIc, whose processor is 
a microprocessor. 


microprocessor: A computer 
processor contained in a single 
integrated circuit, such as the 65C02 
microprocessor used in the 

Apple Ilc. 


microsecond: One millionth of a 
second; abbreviated us. 


millisecond: One thousandth of a 
second; abbreviated ms. 


mode: A state of a computer or 
system that determines its behavior. 


modem: Modulator/demodulator; a 
peripheral device that enables the 
computer to transmit and receive 
information over a telephone line; a 
DCE that connects a DTE to 
communication lines. 


modem eliminator: The physical 
crossing of wires that replaces a pair 
of modems for direct connection of 
two DTEs. 
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modulate: To modify or alter a 
signal so as to transmit information; 
for example, conventional broadcast 
radio transmits sound by 
modulating the amplitude 
(amplitude modulation, or AM) or 
the frequency (frequency 
modulation, or FM) of a carrier 
signal. 


monitor: See video monitor. 


Monitor program: A system 
program built into the Apple IIc in 
firmware, used for directly 
inspecting or changing the contents 
of main memory and for operating 
the computer at the 
machine-language level. 


most significant bit: The leftmost 
bit of a binary number as written 
down. This bit represents 0 or 

1 times 2 to the power one less than 
the total number of bits in the 
binary number. For example, in the 
binary number 10000, which 
contains five digits, the / represents 
1 times 2 to the 4th power—or 16. 


nanosecond: One billionth (in 
British usage, one 
thousand-millionth) of a second; 
abbreviated ns. 
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network: A collection of 
interconnected, individually 
controlled computers, together with 
the hardware and software used to 
connect them. 


nibble: A unit of information equal 
to half a byte, or four bits; can hold 
any value from 0 to 15. Sometimes 
spelled nybole. 


NOT: A unary logical operator that 
produces a true result if its operand 
is false, a false result if its operand 
is true; compare AND, OR, 
exclusive OR. 


NTSC: (1) National Television 
Standards Committee; the 
committee that defined the 
standard format used for 
transmitting broadcast video signals 
in the United States. (2) The 
standard video format defined by 
the NTSC. 


object code: See object 
program. 


object program: The translated 
form of a program produced by a 
language translator such as a 
compiler or assembler; also called 
object code. Compare source 
program. 


odd parity: Use of an extra bit set 
to 0 or 1 as necessary to make the 
total number of 1-bits an odd 
number. 
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opcode: See operation code. 


operand: A value to which an 
operator is applied; the value on 
which an opcode operates. 


operating system: A software 
system that organizes the 
computer’s resources and 
capabilities and makes them 
available to the user or to 
application programs running on the 
computer. 


operation code: The part of a 
machine-language instruction that 
specifies the operation to be 
performed; often called opcode. 


operator: A symbol or sequence of 
characters, such as + or AND, 
specifying an operation to be 
performed on one or more values 
(the operands) to produce a result. 


OR: A logical operator that 
produces a true result if either or 
both of its operands are true, a false 
result if both of its operands are 
false; compare exclusive OR, 
AND, NOT. 


output: Information transferred 
from a computer to some external 
destination, such as the display 
screen, a disk drive, a printer, or a 
modem. 
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overrun: A condition tha t occurs 
when the Apple IIc processor does 
not retrieve a received character 
from the ACIA’s receive data 
register before the subseq uent 
character arrives. The ACIA 
automatically sets bit 2(OVR) of its 
status register; subsequerat 
characters are lost. The receive data 
register contains the last walid data 
word received. 


page: (1) A screenful of imformation 
on a video display, consisting on the 
Apple IIc of 24 lines of 40 or 

80 characters each. (2) An area of 
main memory containing text or 
graphical information being 
displayed on the screen. (3) A 
segment of main memory 256 bytes 
long and beginning at an address 
that is an even multiple of 

206 bytes. 


page zero: See zero pag e. 


parallel interface: An interface in 
which many bits of information 
(typically eight bits, or one byte) are 
transmitted simultaneously over 
different wires or channel s. 
Compare serial interface. 


parity: Maintenance of a sameness 
of level or count, usually the count 
of 1-bits in each character , for error 
checking. 


parity error: Absence of the 
correct parity bit value in a received 
character. The serial port ACIAs 
record this error by setting bit 0 
(PAR) of their statius registers to 1. 


PC board: See printed-circuit 
board. 


phase: (1) A stage in a periodic 
process; a point in a cycle; for 
example, the 65CO2 microprocessor 
uses a clock cycle consisting of two 
phases called 60 and @1. (2) The 
relationship between two periodic 
signals or processes; for example, in 
NTSC color video, the color of a 
point on the screen is expressed by 
the instantaneous. phase of the 
video signal relative to the color 
reference signal. 


pointer: An item of information 
consisting of the memory address of 
some other item. 


pop: To remove the top entry from 
a stack. 


port: The point of connection, 
usually a physica] connector, 
between a compu ter and a 
peripheral device, another 
computer, or a network. 


power supply: The hardware 
component of a computer that 
draws electrical power from a 
power outlet and converts it to the 
forms needed by some other 
hardware component. 


printed-circuit board: A 
hardware component of a computer 
or other electronic device, 
consisting of a flat, rectangular 
piece of rigid material, commonly 
fiberglass, from which all 
conducting material except the 
desired circuits is etched, and to 
which integrated circuits and other 
electronic components are 
connected. 


processor: The hardware 
component of a computer that 
performs the actual computation by 
directly executing instructions 
represented in machine language 
and stored in main memory. 


program: (1) A set of instructions 
describing actions for a computer to 
perform in order to accomplish some 
task, conforming to the rules and 
conventions of a particular 
programming language. (2) To write 
a program. 


programming language: A set of 
rules or conventions for writing 
programs. 


prompt: To remind or signal the 
user that some action is expected, 
typically by displaying a distinctive 
symbol, a reminder message, or a 
menu of choices on the display 
screen. 
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prompt character: A text 
character displayed on the screen to 
prompt the user for some action. 
Often also identifies the program or 
component of the system that is 
doing the prompting; for example, 
the prompt character ] is used by 
the Applesoft BASIC interpreter, > 
by Integer BASIC, and * by the 
System Monitor program. 


prompt message: A message 
displayed on the screen to prompt 
the user for some action. 


protocol: A predefined exchange of 
control signals between devices 
enabling them to prepare for and 
carry out coordinated data transfers. 


push: To add an entry to the top of 
a stack. 


radio-frequency modulator: A 
device for converting the video 
signals produced by a computer to a 
form that can be accepted by a 
television receiver. 


RAM: See random-access 
memory. 
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random-access memory: Memory 
in which the contents of individual 
locations can be referred to in an 
arbitrary or random order. 


raster: The pattern of parallel lines 
making up the image on a video 
display screen. The image is 
produced by controlling the 
brightness of successive dots on the 
individual lines of the raster. 


read: To transfer information into 
the computer’s memory from a 
source external to the computer 
(such as a disk drive or modem) or 
into the computer’s processor from a 
source external to the processor 
(such as the keyboard or main 
memory). 


read-only memory: Memory 
whose contents can be read but not 
written; used for storing firmware. 
Information is written into read-only 
memory once, during manufacture; 
it then remains there permanently, 
even when the computer’s power is 
turned off, and can never be erased 
or changed. Compare read-write 
memory, random-access 
memory, write-only memory. 
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read-write memory: Memory 
whose contents can be both read 
and written; often misleadingly 
called random-access memory, or 
RAM. The information contained in 
read-write memory is erased when 
the computer’s power is turned off, 
and is permanently lost unless it 
has been saved on a more 
permanent storage medium, such as 
a disk. Compare read-only 
memory, random-access 
memory, write-only memory. 


receive data register: A read-only 
register in each serial port ACIA (at 
location $C098 for port 1 and $C0A8 
for port 2) that stores the most 
recent character successfully 
received. 


register: A location in a computer 
processor where an item of 
information, such as a byte, is held 
and modified under program 
control. Registers in the 65C02 
microprocessor include the 
accumulator (A), two index 
registers (X and Y), the stack 
pointer (S), the processor status 
register (P), and the program 
counter (PC). The PC register holds 
two bytes (16 bits); the other 
registers hold one byte (8 bits) each. 


remote: Too distant for direct 
connection using wires or cables 
only. 
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Request To Send: An RS-232-C 
signal from a DTE to a DCE to 
prepare the DCE for data 
transmission. 


return address: The point ina 
program to which control returns on 
completion of a subroutine. 


RF modulator: See 
radio-frequency modu lator. 


RI: See Ring Indicator. 


rigid disk: A disk made of a hard, 
nonflexible material. Compare 
flexible disk. 


Ring Indicator: An optional 
RS-232-C signal from a DCE to a 
DTE that indicates the arrival of a 
call. 


ROM: See read-only memory. 


routine: A part of a program that 
accomplishes some task subordinate 
to the overall task of the program. 


RS-232-C: A standard created by 
the Electronic Industries 
Association (EIA) to allow devices 
of different manufacturers to 
exchange serial data—pa rticularly 
via telephone lines. 


RTS: See Request To Send. 


run: (1) To execute a program. 
(2) To load a program into main 
memory from a peripheral storage 
medium, such as a disk, and 
execute It. 


save: To transfer information from 
main memory to a peripheral 
storage medium for later use. 


screen: See display screen. 


scroll: To change the contents of 
all or part of the display screen by 
shifting information out at one end 
(most often the top) to make room 
for new information appearing at 
the other end (most often the 
bottom), producing an effect like 
that of moving a Scroll of paper past 
a fixed viewing window. See 
viewport, window. 


serial interface: An interface in 
which information is transmitted 
sequentially, one bit at a time, over 
a single wire or channel. Compare 
parallel interface. 


setup time: The amount of time a 
signal must be valid in advance of 
some event; compare hold time. 


silicon: A nonmetallic, 
semiconducting chemical element 
from which integrated circuits are 
made. 


soft switch: A means of changing 
some feature of the Apple IIc from 
within a program; specifically, a 
location in memory that produces 
some special effect whenever its 
contents are read or written. 


software: Those components of a 
computer system consisting of 
programs that determine or control 
the behavior of the computer. 
Compare hardware, firmware. 


source code: See source 
program. 


source program: The original 
form of a program given to a 
language translator such as a 
compiler or assembler for 
conversion into another form; 
sometimes called source code. 
Compare object program. 


space character: A text character 
whose printed representation is a 
blank space, typed from the 
keyboard by pressing the SPACE 
bar. 


SPACE parity: A bit of value 0 
appended to a binary number for 
transmission. The receiving device 
can look for this value on each 
character as a means of error 
checking. 
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stack: A list in which entries are 
added or removed at one end only 
(the top of the stack), causing them 
to be removed in LIFO 
(last-in-first-out) order. 


start bit: A transition from a 
MARK signal to a SPACE signal for 
one bit-time, indicating that the 
next string of bits represents a 
character. 


Status register: A register in an 
ACIA (at location $C099 for port 1 
and $COA9 for port 2) that stores the 
state of two of the RS-282-C signals 
and the state of the transmit and 
receive data registers, as well as the 
outcome of the most recent 
character transfer. 


stop bit: A MARK signal following 
a string of data bits (or their 
optional parity bit) to indicate the 
end of a character. 


string: An item of information 
consisting of a sequence of text 
characters. 


strobe: (1) An event, such as a 
change in a signal, that triggers 
some action. (2) A signal whose 
change is used to trigger some 
action. 


subroutine: A part of a program 
that can be executed on request 
from any point in the program, and 
which returns control to the point of 
the request on completion. 
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television receiver: A display 
device capable of receiving 
broadcast video signals (such as 
commercial television) by means of 
an antenna. Can be used in 
combination with a radio-frequency 
modulator as a display device for 
the Apple IIc computer. Compare 
video monitor. 


terminal: A device consisting of a 
typewriterlike keyboard and a 
display device, used for 
communicating between a computer 
system and a human user. Personal 
computers such as the Apple IIc 
typically have all or part of a 
terminal built into them. 


terminal mode: An operating state 
of the Apple IIc communication port 
in which the firmware makes the 
computer act like a simple ASCII 
terminal. 


text: (1) Information presented in 
the form of characters readable by 
humans. (2) The display of 
characters on the Apple Ilc’s display 
screen. Compare graphics. 


text window: An area on the 
Apple IIc’s display screen within 
which text is displayed and scrolled. 
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transistor-to-transistor logic: 
(1) A family of integrated circuits 
used in computers and related 
devices. (2) A standard for 
interconnecting such circuits that 
defines the voltages used to 
represent logical 0s and Is. 


transmit data register: A 
write-only register in one of the 
serial port ACIAs (at location $C098 
for port 1 and $COA8 for port 2) that 
holds the current character to be 
transmitted. 


troubleshoot: To locate and 
correct the cause of a problem or 
malfunction in a computer system. 
Typically used to refer to 
hardware-related problems; 
compare debug. 


TTL: See 
transistor-to-transistor logic. 


unary operator: An operator that 
applies to a single operand; for 
example, the minus sign (—) ina 
negative number such as —6is a 
unary arithmetic operator. 


user: The person operating or 
controlling a computer system. 


user interface: The rules and 
conventions by which a computer 
system communicates with the 
person operating it. 
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vector: (1) The starting address of 
a program segment, when used as a 
common point for transferring 
control from other programms. (2) A 
memory location used to hold a 
vector, or the address of such a 
location. 


video: (1) A medium for 
transmitting information in the form 
of images to be displayed on the 
screen of a cathode-ray tu be. 

(2) Information organized or 
transmitted in video form. 


video monitor: A display device 
capable of receiving video signals by 
direct connection only, and which 
cannot receive broadcast signals 
such as commercial television. Can 
be connected directly to the 

Apple IIc computer as a display 
device. Compare television 
receiver. 


viewport: All or part of the display 
screen, used by an application 
program to display a portion of the 
information (such as a document, 
picture, or worksheet) that the 
program is working on. Compare 
window. 


warm start: The process of 
restarting the Apple Ilc after the 
power is already On, without 
reloading the operating system into 
main memory and often without 
losing the programn or information 
already in main memory. Compare 
cold start. 


window: The portion of a collection 
of information (such as a document, 
picture, or worksheet) that is visible 
in a viewport on the display screen; 

compare viewport. 


word: A group of bits of a fixed size 
that is treated as a unit; the number 
of bits in a word is a characteristic 
of each particular computer. 


wraparound: The automatic 

continuation of text from the end of 
one line to the beginning of the next, 
as on the display screen or a printer. 


write: To transfer information from 
the computer to a destination 
external to the computer (such as a 
disk drive, printer, or modem) or 
from the computer’s processor to a 
destination external to the processor 
(such as main memory). 


X register: One of the index 
registers in the 65C02 
microprocessor. 


Y register: One of the index 
registers in the 65C02 
microprocessor. 
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zero page: The first page 

(256 bytes) of the Apple IIc’s 
memory, also called page $00. Since 
the high-order byte of any address 
in this page is 0, only the low-order 
byte is needed to specify a zero-page 
address; this makes zero-page 
locations more efficient to address, 
in both time and space, than 
locations in any other page of 
memory. 
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PRINTER command 145 
printer port See port 1 
PrntAX routine 107 
processor 12 
processor status register 16 
ProDOS 316 
program counter (PC) 16, 208 
prompt characters 55 
protocol, firmware 67 
for mouse port 181 
for port 1 149 
for port 2 162 
for port 3 108 
Protocol Converter 
calls to 117-118 
entry point 115 
PStatus routine 68, 110 
entry point of 149, 162 
PTrig switch 177 
PWrite routine 67, 109 
entry point of 149, 162 
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Q command 159 
question mark (?) 55 
quitting terminal mode 159 
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Rcommand 147, 159 
RAM address(es) 20 

multiplexing 236 
RAM addressing 234-237 
RAMR¢d switch 37 
RAMWrt switch 37 
random-number routine 55 
RCA-type phono jack 81 
Rd80Col switch 95 
Rd80Store switch 48, 95 
RdAltChar switch 95 
RdAItZP switch 26 
RdBnk2 switch 26 
RdBtnO switch 178 
RdChar routine 76 
RdDHiRes switch 44, 96 
RdHiRes switch 43, 96 
RdIOUDis switch 44, 96, 177 
RdKey routine 54 
RdLCRAM switch 26 
RdMIXED switch 95 
RdPage2 switch 43, 95 
Rd63 switch 178 
RdTEXT switch 95 
RdVBIMsk switch 177 
RdXOEdge switch 177 
RdXYMsk switch 177 
RdYOEdge switch 177 
READ BLOCK call 128-124 
READ call 133-134 
ReadMouse routine 180 
receiver clock source 261, 262 
registers 16 

changing 197 

examining 197 
remote mode 171 
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Request To Send (RTS) 263 

(RESET) key 4, 47, 76 

reset routine 47-48 

reset vectors 48-50 

reset(s) 
cold-start (power-on) 49, 130 
forced cold-start 49-50 
warm-start 49, 128 

[RETURN] key 4 

RF video modulator 80 

ROM addresses 20-21 

ROM addressing 233-234 

row-address strobe (RAS) 236 

RstVBI switch 177 

RstXInt switch 177 

RstXY switch 177 

RstYInt switch 177 

RTS (Request To Send) 263 
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Scommand 147, 159 

S register 16 

safety instructions 217, 371 
schematic diagrams 274-280 
screen alignment 59 


screen hole locations 36, 69-70, 298 


in auxiliary memory 301 
inmain memory 299-300 
mouse port 182 
port 1 150 
port 2 162 
SCRN routine 107 
scrolling 60-62 
SEC instruction 41 
serial port 1 20 
serial port 2 20 
serial port circuits 258 


ServeMouse routine 175, 180 
SetCol routine 107 
SetMouse routine 179, 180 
SetPWRC routine 50 
[SHIFT] Key 5 
Sholes keyboard 5-6, 355 
6 CONTROL-K command 112 
6 CONTROL-P command 88, 112, 113 
65C02 microprocessor 12 
block diagram of 220 
data sheet for 283-292 
registers 16 
specifications 223 
versus 6902 282-283 
signals 
character-generator control 250 
disk drive connector 257 
external power connector 218 
14-MHz video timing 249 
GLU 230 
hand controller 273 
hand controller connector 271 
IOU 227 
IWM 23] 
keyboard 239 
memory selection 238 
MMU 226 
mouse button 269 
mouse connector 267 
RAM timing 236-237 
serial port connector 261 
7-MHz video timing 248 
65C02 timing 223-225 
6551 260 
TMG 229 
video output 253-256 
slot equivalents 66 


soft switches 18, 22 
bank selector 25 
display 95-96 
display memory 48, 44 
48K memory 387 
hardware functions of 21-22 
memory addresses of 21-22 
mouse 177-178 
resetting to normal 47-48 
speaker 77 
(é) 4, 50, 76 
SPACE parity 152 
speaker 
characteristics 77 
operation of 240 
toggle 22 
using 77 
volume control 7, 240 
special function keys 4 
specifications 
environmental 216-217 
50-Hz power supply 372 
internal converter 219 
keyboard 4 
power supply 218 
65C02 microprocessor 223 
video display 81 
speed adjustment, disk drive 13 
stack 18, 24 
stack pointer 16 
standard (Sholes) keyboard 5-6 
start bit 152 
startups 
cold-start routine 113 
from external drive 114 
warm-start routine 113 
STATUS call 119-123 
status register, ACIA 264 
STEP command 205-207 
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stop-list function 61, 62-63 
strobe 
inputs 21 
outputs 22 
Super Serial Card 144, 156, 349 
Sw0 185 
Swl 185 
switch inputs 185, 270 
switches 
address space (memory) 21-22 
bank selector 25-33 
character output 58 
keyboard input 53 
soft 18, 21-22 
sync pulses 241 
synchronization signals 241 
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T command 159 
key 4 
television set 
and colors 87, 89-90 
and display width 84 
and high-resolution graphics 90 
as monitor 80 
vertical line count and 242 
terminal mode 159, 166, 171 
text capacity specifications 81 
text display(s) 
characteristics 86 
80-column 5, 80, 84, 93 
40-column 5, 80, 84, 93 
generating 247 
switching 86 
text modes 82 
TEXT switch 91, 95 
text window 
changing 63 
values for parameters 64 
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timing generator (TMG) 229 
timing signals 223-225 
TLP1 34, 93 

TLP1X 36, 98 

TLP2 36, 93 

TLP2X 36 

TMG (timing generator) 229 
TMG chip 262 

toggle switches 22 

TRACE command 205-207 
transmit /receive register, ACIA 265 
transparent mode 175 

2 CONTROL-P command 156 
two-key rollover 118 
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UniDisk 3.5 112 
and mouse interrupts 179 
and slot 7 348 
cold starts with 50 
communicating with 114-115 
debugging commands 205-207 
ROM size 233-234 
starting up from 118, 114 
USER command 202 
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validity-check byte 49, 50 
VBiInt signal 175, 178 
vectors, Monitor 313-314 
ventilation 8 
VERIFY command 196, 201 
vertical blanking active modes 176 
vertical-count bits 244 
video control functions 109-110 
video counters 
horizontal 241-242 
vertical 242 
video display 
operation of 24] 
specifications 81] 
video output firmware entry points 20 
video port characteristics 80 
video signal 81 
VLine routine 108 
voltage converter 10-11 
voltages 
50-Hz power supply 372 
internal converter 219-220 
power supply 218 
65C02 microprocessor 223 
volume control 7, 240 
VTab 60 
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warm-start reset 49, 128 
warm-start routine 113 
Western Spanish keyboard 368 
WRITE BLOCK call 124-125 
WRITE call 134-135 
write-enable addresses 25 
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X command 147, 159 
X register 16 
and port routines 68 
X1 266 
XFer routine 40-42 
XInt 178 
X0 176, 265 
X0Edge switch 177 
XON/XOFF protocol 147, 159 
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Y register 16 
and port routines 68 
Y1 266 
YInt 178 
YO 176, 265 
YOEdge switch 177 
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Zcommand 147, 154, 159 

zapping command characters 147, 154, 
159 

zero page 18, 24 


